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Realizer - 


A BASIC 


Applications 
Development Tool 
for Windows 


With all the various dialects of BASIC in existence, is the 
world really ready for yet another - even if it is for 
Windows? But Mark Hamilton thinks Realizer could 
realise the ambitions of Quick Basic aficionados. 


here are more dialects of the 
"Tess language than any other. 

Microsoft, the company which 
popularised the language, seems un- 
able to decide on a ‘standard’ and it is 
guiltier than most of introducing vari- 
ations. However, the most popular of 
all these is, undoubtedly, QuickBasic. 
Programmers like the ease in which 


they can create quite complex applica- 
tions without the heavyweight baggage 
imposed by the Professional Develop- 
ment System (BASIC PDS). For this rea- 
son, there are literally hundreds of com- 
mercial and shareware third-party 
add-ons and libraries - BASIC for the 
masses, one might say. 

In an attempt to popularise Win- 
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Figure 1 - FORMDEYV is used to design Forms and Windows 
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dows - and to get more people develo- 
ping applications for it - Microsoft 
brought out Visual Basic. At the very 
least this represented an alternative de- 
velopment environment for Windows, 
previously the preserve of perverse C 
programmers. But as traditionalists 
quickly discovered, Visual Basic used a 
different programming metaphor to 
QuickBasic - it was an event-based lan- 
guage built around Forms (or applica- 
tion Windows). The underlying applica- 
tion language bore a passing resem- 
blance to QuickBasic, but there was no 
real compatibility. However, because it 
was first and because it was marketed 
by Microsoft (who did not, incidentally, 
write it), it became quite popular. 


Enter Within 


Last Autumn, a New Jersey based 
company called Within Technologies 
launched Realizer. This is a fully-fledged 
application development environment 
which comprises the following basic ele- 
ments: 


@ Interactive Development Environ- 
ment in which to develop and debug 
programs; 

A set of programmable tools that can 
be incorporated into programs: 
Charts, Spreadsheets, Forms, Anima- 
tion and Graphics; 

A dialog box designer - for which 
the full source code is provided as an 
example of a full-blooded Realizer 
application; 

Run time compiler and application 
delivery system. 


Realizer appeared during the Beta 
stage of Windows 3.1 and it runs hap- 
pily under both 3.1 and 3.0. But it does 
not run under OS/2 2.0’s Windows 
emulator (WIN-OS/2). According to 
IBM, Realizer uses undocumented Win- 
dows features, which would com- 
promise the integrity of OS/2, and is 
thus a ‘dirty’ application (in point of 
fact, Realizer is one of only a handful of 
Windows applications not supported 
by WIN-OS/2). Any attempt to execute 
Realizer under WIN-OS/2 fails and 
crashes OS/2 so thoroughly that it’s hit 
the big red switch time. 

Realizer is delivered on three high 
density diskettes and the company 
thoughtfully provides both 5.25 and 3.5 
inch diskettes as standard. It is installed 
just like any other Windows application 
- from the File/Run menu of Program 
Manager. The installation program cre- 
ates its own directory structure, copies 
and expands all the various compo- 
nents and creates a Program Manager 
Group for Realizer. Unlike some Win- 
dows applications I could mention, 
whose Program Manager Group con- 


tains but one item, Realizer’s has quite 
a few. 

At this stage, it is worth mentioning 
the documentation - and there’s quite a 
lot of it. A 340+ page User’s Guide acts 
as both an introduction and tutorial; the 
590 page Reference Manual describes the 
language’s syntax and documents all 
the commands and functions; a 100+ 
page Library Guide describes the func- 
tions provided by the various accessory 
libraries; a 40+ page booklet on Form- 
Dev, Realizer’s dialog box editor; a 30 
page Runtime Guide describes how to 
compile applications and create installa- 
tion disks; an Installation Guide and fur- 
ther booklet describing differences be- 
tween Realizer and other BASIC dia- 
lects as well as detailing which 
third-party applications’ files can be 
used by Realizer. 

In truth, QuickBasic programmers 
will quickly adapt to Realizer - the two 
dialects are surprisingly similar. Most 
of QuickBasic’s built-in commands, 
functions and procedures are either di- 
rectly supported or have close, often en- 
hanced, Realizer counterparts. There 
are (of course) a number of unsup- 
ported commands, but mostly these 
could not be supported due to the na- 
ture of the Windows environment. 
These include screen and graphics com- 
mands (eg CIRCLE, SCREEN and WIN- 
DOW); device-specific commands (eg 
COM, PLAY and STRIG); system-related 
commands (such as DEF SEG, PEEK and 


REALIZER 


SADD) and error-trapping commands 
(ERRDEV, ON ERROR and UEVENT). 
There are also several miscellaneous 


A really useful 
option is the ability 
to build a delivery 
disk, including an 
installation program 


commands that Realizer does not sup- 
port, such as COMMANDS, MKSMBF$ and 
OPTION BASE. 

Like Visual Basic, Realizer uses the 
Form metaphor. Individual forms can 
comprise, at the simplest, a dialog box, 
and can be built-up with ever increas- 
ing levels of complexity to include bit- 
maps, spreadsheets, charts, tickers and 
custom controls. In Realizer-speak, a 
Form is simply a window in which a 
number of objects - such as a button, a 
chart or a text string - can be placed and 
to which items of initialisation and pro- 
cessing code can be attached. In this re- 
spect, it is very similar to Visual Basic. 

For simplicity, most users will use 
FORMDEV as the starting point to their 
form or window design (see Figure 1). 
This provides a complete palette of all 
object-types that can be included in the 


DIOS CIO CACTI OICIC ICICI ICICI CII ICICI IOI III ACI 


ae FormName: Vitlstat 


PROC MakeVit1Stat 
formvitlstat = FormQUnique 
FormNew(formVitlstat; \ 

“Personal Information", \ 
Title + _Minimize) 
37.0 pet, 60.6 pet) 


FormSetObject (20, _TextBox, "", 
2.4 pet, 66.0 pet, _Default) 


Tyra) 


Dy) 


FormSetObject (70, _TextBox, "", 
51.8 pet, 46.8 pet, _Default) 

FormSetObject (80, _CaptionLeft, \ 
Default, _Default) 


68.0 pct, 46.8 pet, _Default) 


ICICI III III IOI ICICI IOC ICICI IOI III III I I ICI II Ik 


‘ NB lines split using C '\' conventions 


FormControl(_Size; 35.0 pet, 15,2 pet, \ 


FormSetObject(10, _CaptionLeft, "Name:",\ 
5.1 pet, 3.6 pet, _Default, _Default) 
28.9 pet,\ 


FormSetObject (30, _GroupBox, "Sex", \ 
Center, 16.6 pet, 56.2 pct, 31.6 pet) 

FormSetObject (40, _OptionButton, "Male",\ 
31.5 pet, 24.3 pet, 22.1 pet, 10.1 pet;\ 


FormSetObject (50, _OptionButton, "Female", \ 
31.5 pet, 34.8 pet, 28.9 pet, 10.1 pet; \ 


FormSetObject (60, _CaptionLeft, "Age:",\ 
28.5 pet, 54.3 pet, _Default, _Default) 
48.1 pct,\ 


"Date of birth:", 5.1 pet, 69.2 pet, \ 


FormSetObject (90, _TextBox, "", 48.1 pct,\ 


END PROC 


LOOP 


rv(1) 
rv[2] 
rv [3] 


RETURN rv 
CASE 2 
RETURN 0 
END SELECT 
END LOOP 
RETURN 1 
END FUNC 
‘Main program 


MakeVit1Stat 


FormSetObject(1,  DefButton, "OK", _Left,\ 
Bottom, 29.8 pet, 10.9 pct) 

FormSetObject (2, _DefButton, "Cancel", \ 
Right, _Bottom, 29.8 pct, 10.9 pct) 


FUNC Modalvitlstat 
FormSelect (formvit1Stat) 


SELECT CASE FormWait 

CASE 1 ‘OK 

FormQStr (20) 

IF FormQNum(40) THEN "1" ELSE "2" 
FormQStr (70) 

rv(4} = FormQStr (90) 

FormControl (_Close) 


design. All the normal Windows objects 
are provided - such as textbox, frame, 
checkbox, buttons, combo and list boxes 
- as well as those that are Realizer-spe- 
cific, including a digital clock, chart, bit- 
map and spreadsheet. You have com- 
plete control on how individual objects 
look and you can change not only the 
font used, but also the background and 
foreground colours of individual ob- 
jects. You can also change a bitmap 
from being a static object into a button, 
by simply modifying its attributes in a 
easy-to-use Options dialog. 

If you want to replace the standard 
Windows OK button with a large green 
tick (like Borland’s), you create the tick 
using Windows Paintbrush and save it 
asa .BMP file. Then, in FORMDEV, you 
include it as a bitmap and change its at- 
tribute to Bitmap Button. You can then 
write the BASIC code to handle this con- 
trol (the new ‘button’) in an Action Win- 
dow. 

Forms can also have initialisation 
code attached - such as greying buttons 
or filling a directory list box with names. 

Completed forms are saved as .RFD 
(for Realizer Form Design) files. Unlike 
Visual Basic, which uses Forms resour- 
ces directly, Realizer needs the form 
translated into code. FORMDEV takes 
care of this, translating the form into a 
series of BASIC procedures which cre- 
ate and initialise the form. Any code 
that you've written to handle individ- 
ual controls is also output. Figure 2 con- 


‘Cancel 
FormCont rol (_Close) 


FormSelect (formVit1Stat) 
FormCont rol (_Close) 


dummy = Modalvitistat 


Figure 2 - Sample code generated by FORMDEV 
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To discover how the new 
Microsoft*C/C+ +70... 


class In_One_ Package 

{ 
// Provides everything 
// to develop powerful 
// Windows applications 


UUNUNOLLUUUNA 


By almost any standard, the new 


Microsoft C/C++ version 7.0 Develop- 


ment System is the best way to create 
Windows and MS-DOS 
applications. 

Take the Microsoft Founda- 
tion Classes (MFC), for example. 
Because they have the most com- 
plete framework for Windows, 
you'll have everything you need 


to develop full featured Windows 


applications, including support for Pen, 


Multimedia, and Object Linking and 
Embedding (OLE). 


A smooth transition 
from C to C++ 


In addition, MFC libraries provide a 
smooth transition from C to C++ 
programming, by providing a familiar 
interface and programming model to 
Windows developers. Full source code 
for the class libraries is also included. 

Microsoft C/C++ 7.0 also includes 
over 76,000 lines of sample code (in both 
C and C++) for developers who want to 
learn how to implement new functionality 
in Microsofts Windows: 3.1. 

These features alone would seem to 


justify a premium price. Yet at just £335 


R.R.P. (or £99 for the upgrade)* C/C++ 
7.0 also comes complete with the 
Microsofts Windows 3.1 Software 
Developer’s Kit, 386 MAXe 6.0 
and the Microsoft Source Pro- 
filer. That’s over £380 worth of 


software at no extra cost. 


Execute 


this simple function 


To find out more about these 
savings and to receive a free, detailed 
information sheet, the only thing you 


need do is execute this simple function: 


Call Microsoft today on 


081-879 7979 
Microsoft: 


To send for your free information sheet on C/C++7.0, 
simply complete and return this coupon to: 


Microsoft Ltd, FREEPOST, 
19 Worple Road, Wimbledon SW19 4YY. 


Name (Mr/Mrs/Miss/Ms) 


Job title 


Company. 


Address 


Postcode 


Telephone No. ( ) 
Do you already develop 
applications for Windows? Yes No 


Do you already use C++? Yes No 


*Upgrade offer expires 30th June, 1992. The upgrade excludes certain printed SDK manuals which are available for an extra £99, 
386 MAX is a registered trademark of Qualitas, Inc. 
Microsoft and the Microsoft logo are registered trademarks and Windows is a trademark of the Microsoft Corporation. 
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tains some code generated in this way. 
The main Realizer program - see Fig- 
ure 3 - is used to write and edit your ap- 
plication files. You can also test your 
program without having to ‘build it’. 
The development environment includes 
a debugger which will step through 
your program one line at a time - you 
can elect to step-over procedures - and 
you can bring up windows that display 
all your variables and watch them 
change as your program progresses. I 


file dit 


Window Help 


REALIZER 


found the environment uncluttered and 
easy to use. 

Realizer is a rich dialect which incor- 
porates a total of 287 functions and pro- 
cedures (or keywords) and 294 pre- 
defined constants. These are distin- 
guished from other keywords by an 
underbar being prepended to the name. 
A large number of keywords and con- 
stants relate directly to the Windows en- 
vironment. For example: Result = 
MessageBox ("Can‘t read disk in 
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Figure 4 - The Project Builder 


Windows Supplement to .EXE Magazine - June 1992 


driveA", "Disk Error", _MB_Ex- 
clamation, _MB_AbortRetryCan- 
cel) paints a Message Box on the 
screen and returns an integral result de- 
pending on which button (Abort, Retry 
or Cancel) is selected and pressed. 

Other keywords are specific to the 
various object-types that Realizer in- 
cludes - the charts, spreadsheets and so 
on. 

It is Realizer’s external capabilities 
which make this a very powerful devel- 
opment system. You can import and ex- 
port Lotus and Excel spreadsheet files 
and ‘talk’ to other running Windows ap- 
plications using DDE: a Realizer pro- 
gram can act as either a DDE Client or 
as a DDE Server. But OLE (Object Link- 
ing and Embedding) is not supported, 
nor are other Windows 3.1-specific envi- 
ronment enhancements. 

Realizer can also use external (third- 
party or ‘home-grown’) libraries pro- 
vided they are available as DLL files. 
You can build an application that ac- 
cesses Paradox tables if you have a 
copy of Borland’s Paradox Engine - or 
you can write your own set of library 
routines (in C, C++ or Pascal). See Fig- 
ure 5 for a small, complete Realizer pro- 
gram which is a front end to PKZIP. 


Delivery 


Realizer can create ‘not quite stand- 
alone’ applications. I say ‘not quite 
stand-alone’ because, like Visual Basic, 
Realizer’s applications require one or 
more run-time libraries to be accessible, 
even though Realizer’s compiler creates 
.EXE files. Actually, Realizer’s compiler 
doesn’t create true .EXE files, it writes 
an .EXE stub followed by a tokenised 
and compressed version of the BASIC 
source. This is interpreted by the main 
run-time program, although it is the ap- 
plication’s .EXE file that you invoke, 
nota run-time’s. 

The Realizer Application Builder 
(see Figure 4) is a powerful project man- 
agement system cum compiler cum pro- 
duct delivery-creator. The first time you 
run it on a new project, it scans your 
main program’s source file and tries to 
satisfy all external references to other 
source files, such as libraries and bit- 
maps. Those that can’t be found are 
highlighted in the project window. You 
then work your way through the list of 
unresolved items - normally a case of 
satisfying path references. Once the list 
is complete, you can save all the infor- 
mation thus gathered into a project file 
ready for next time. 

Selecting the compile option creates 
your .EXE which includes all the bit- 
maps (but not external libraries) and 


you can then include this file in a Pro- 
gram Manager group. 

A really useful option is the ability to 
build a delivery disk. This includes an 
installation program and all the files 
necessary to run the application. The in- 
stallation program can be tailored so 
that optional items (such as icons or 
Read-Me files) need not be copied over 
to the final end-user’s machine. There 
does not appear to be any run-time roy- 
alties payable, so you can create and dis- 
tribute Realizer applications willy-nilly. 


Conclusion 


Realizer is a well thought-out and de- 
signed applications development envi- 
ronment that is more than a match for 
Microsoft’s Visual Basic. It is immense- 


REALI Z EoR 


ly powerful, yet easy to use, very well 
documented - both in hard copy and in 
the form of on-line help. If you get 


QuickBasic 
programmers will 
quickly adapt to 
Realizer - the two 
dialects are 
surprisingly similar 


stuck, or need assistance, Within Tech- 
nologies has a support conference on 
CompuServe and I found that the com- 


pany’s support staff provided prompt 
and knowledgeable service. 

The company is currently working on 
the next version which is due to be laun- 
ched at Comdex Fall (November) and it 
promises much more of the same as well 
as some innovative developments. 


Mark Hamilton is a freelance technical 
journalist specialising in operating systems 
and all manner of things to do with comput- 
ing generally. He hasn't used BASIC in anger 
since the dark days of CP/M since he was 
weaned on grown-up languages (C and As- 
sembler). 


Mark reviewed Realizer Version 1 from 
Within Technologies, distributed in the UK 
by Equinox Business Systems (071 729 
0990). The product costs £295. 


* A small Realizer program that provides a 
' front end to PKZIP, Note that PKZIP must 
' be on the PATH for this app to work 

‘"\" character used to show split lines - 

‘ but this does not work with the current 

‘ version of Realizer - all statements must 
‘ be complete. 
ecererreoeerrrr rrr Terre rrr etre rr etre te! 


tae FormName: zipper 
BISSETT IIIS BASIS 
RUN "Stdsys" 

PROC Makezipper 

formzipper = FormQUnique 

FontNew(1; "Terminal", 8) 

FormNew(formzipper; "Forml", Close 

FormSetColor (_LightGray) 

FormSetColor (_LightGray; _Field 

FormControl(_size; Center, Center, \ 
100 pet, 100 pet) 

FormSetObject (10, _CaptionLeft, \ 
“zipped Name:", 2.7 pet, 6.2 pct, \ 
—Default, _Default) 

FormSetColor(_White; Field) 

FormSetObject (20, _TextBox, “"myzip*,\ 
29 pet, 4.8 pet, 65 pet, _Default) 

FormSetObject (170, TextBox, QDir, \ 

29 pet, 18 pet, 65 pet, _Default;\ 
Notify) 

FormSetObject (30, _ListBox, "Source", \ 
1, 2.7 pet, 34.8 pet, 30.0 pet, \ 
34.9 pet; Sorted, _ListFiles, \ 

-NormFiles + _Drives + _SubDirs, “*.**) 

FormSetObject (60, ListBox, "To Zip", 1,\ 
37.6 pet, 34.8 pet, 30.0 pet, 34.9 pet) 

FormSetColor(_LightGray; _Field) 

FormSetObject (160, _CaptionLeft, \ 
“Current Directory:", 2.7 pet, 19 pet 

FormSetObject (70, _GroupBox, "Options", \ 
71.2 pet, 30 pet, 27.1 pet, 37 pet) 

FormSetObject (80, _CaptionLeft, \ 

“All Files", 2.7 pet, 28.6 pet, \ 
Default, Default) 

FormSetObject (90, _CaptionLeft, \ 

“Files to ZIP", 37.6 pet, 28.6 pet,\ 
Default, _Default) 

FormSetObject (110, _OptionButton, \ 
“Add Files", 72.1 pct, 38.0 pct,\ 
20.7 pet, 5.9 pet; 1, 1) 

FormSetObject (120, _OptionButton, \ 
"Delete Files", 72.1 pct, 45.0 pct,\ 
22.8 pet, 6.2 pet; 0, 1) 

FormSetObject (130, _CheckBox, \ 
“Preserve Dirs", 72.3 pct, 55 pct,\ 
23.9 pet, 6.7 pet; 0, 1) 

FormSetObject (140, _Button, “Include >",\ 
2.7 pet, 70.6 pet, 30.0 pet, 7.2 pet) 

FormSetObject (150, Button, "Remove", \ 
37.6 pet, 70.6 pet, 30.0 pet, 7.2 pet) 

FormSetObject (190, _Button, “Zip It!",\ 
17.5 pct, 88 pct, 20.3 pet, 10.5 pet) 

FormSetObject (2, Button, "Cancel", \ 
55.6 pet, 88 pet, 20.3 pet, 10.5 pet) 

FormSet Proc (formproczipper 

END PROC 


PROC formproczipper (params 
LOCAL tname 
FormSelect (formzipper) 
SELECT CASE params {_ItemNum) 
CASE 190 ‘Zip It 
‘Get the names the user selected 
‘and write them in an @ list 
FilesToZip = Formgstr(60, 1) 
tname = FileMakeName 
FileOpen(1, tname, _Write) 
FileWrite(1, FilesToZip 
FileClose(1) 
‘Read option buttons & build zip comnd 
IF FormQNum(120) THEN 
Zipcmd = "PKZIP -d * 
ELSE 
ZipCmd = "PKZIP * 
END IF 
IF FormQNum(130) THEN 
Zipcmd = Zipcma + "-P * 
END IF 
‘create a batch file with target name 
‘and @ list the batch file cleans up 
‘the temp files 
Zipcmd = Zipcmd + Formgstr(20) + \ 
“ @" + tname 
FileOpen(1, "Zipper.Bat", Write 
FileWrite(1, ZipCmd) 
Filewrite(1, "DEL " + tname 
PileWrite(1, "DEL Zipper.BAT" 
FileClose(1) 
‘call up the Zip routine. 
‘ Note that it is a DOS program 
‘PKZIP MUST BE ON THE DOS SEARCH PATH 
SHELL "zipper.bat", _DOS 
CASE 2 ‘Cancel 
EXIT SYSTEM 
CASE 30, 140 '> Ada 
‘Copy a name from the source to 
‘the target listbox. 
name = Form@str (30) 
IF Left$(name, 2) = "{-" THEN 
‘Change drive 
CheckMultiDir 
SetDir(Mid$(name, 3, 1) + ":\", \ 
—ChangeDrive) 
FormModifyObject (30, _Clear 
FormModifyObject (30;  _ListFiles,\ 
NormFiles + _Drives + _SubDirs,\ 
we any 
FormModifyObject (170, Normal, QDir) 
ELSEIF Left$(name, 1) = "(" THEN 
‘Change directory 
CheckMultibir 
SetDir(Mid$(name, 2, Len(name) - 2) 
FormModi fyObject (30, _Clear) 
FormModifyObject (30; _ListFiles, \ 
NormFiles + _Drives + _SubDirs,\ 
ween) 
FormModifyObject (170, _Normal, QDir 
ELSE 
IF MultiDir THEN 
FormModi fyObject (60; \ 
FileQ(name, _Name) ) 


ELSE 
FormModifyObject (60; name) 
END IF 
END IF 
FormModifyObject (30; _ListDelete, \ 
FormgNum (30) ) 
CASE 60, 150 “Remove 
"Remove an item from the target listbox 
name = Form@str (60) 
FormModifyObject (60; _ListDelete, \ 
FormQNum (60) ) 
FormModi fyObject (30; name) 
CASE 170 ‘change directory 
name = FormQStr(170) 
CheckMultiDir 
IF Mid$(name, 2, 1) = ":" THEN 
SetDir(name, _ChangeDrive. 
ELSE 
SetDir (name) 
END IF 
FormModifyObject (30, Clear) 
FormModifyObject (30; _ListFiles, 
_NormFiles + _Drives + _SubDirs, \ 
weeny 
FormModifyObject (170, Normal, QDir) 
END SELECT 
END PROC 
PROC CheckMultidir 
LOCAL names, J 
‘See if there are files selected, 
multidir 
‘is not on, and the directory has changed 
IF Endvalid(Formgstr(60, -1)) 1 \ 
AND NOT MultiDir THEN 
Multidir = 1 
‘Give a full path to all listbox items 
names = Formgstr(60, 1) 
FormModi fyObject (60, _Clear 
FOR J = 1 TO EndValid(names 
FormModi fyObject (60; \ 
FileQ(names (J), _Name)) 
NEXT J 
END IF 
END PROC 
‘Main program 
MenuSelect (_HelpMenu) 
MenuControl (_Hide) 
MenuSelect (_WindowMenu 
MenuCont rol (_Hide) 
MenuSelect (_RunMenu) 
MenuCont rol (_Hide) 
MenuSelect (_EditMenu) 
MenuControl (_Hide) 
MenuSelect (_FileMenu) 
MenuCont rol (_Hide) 


Multidir = 0 
SetSys(_Size, \ 
{_Center, _Center, 74 pct, 85 pct}) 
Makezipper 
FormSelect (formzipper) 
FormControl (_Show 


Figure 5 - Demonstration Realizer program - a front end to PKZIP 
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MULTIMEDIA 


Microsoft 
Gives Birth 


‘Multimedia’ is the tag which shifts computer boxes these 
days, but there's comparatively little sensibly-priced 
material for the programmer. Jeffrey Goldberg takes a look 
at Microsoft’s MDK for Windows. 


Fat just oozes out as people, typi- 

cally greasy marketing types, try to 
define the indefinable and then give it 
the label ‘multimedia’ as shorthand for: 
‘We don’t know what the hell it is, but 
if we give it GTi stripes it’s bound to 
sell.’ It follows from this that a 
‘Multimedia Development Kit’ is a pot- 
pourri of disparate bits and pieces 
thrown together and given the magic 
word, when the alternative word ‘free’ 
might be more appropriate. Of course, 
to complete the spell, the kit must come 
ina pretty box. 

Now, I’m not accusing Microsoft of 
joining the wave of people exploiting 
the magic M word. However, there is 
little coherence about the Microsoft 
Multimedia Development Kit (MDK), 
and it does have a box with a tasteful 
colour scheme and snazzy graphics. 
Neither does the kit match some 
people's definition of multimedia; in 
particular, you cannot compress or con- 
trol full motion video in any sensible 
way. What it does provide are the tools 
and APIs to produce electronic books, 
control stereo sound, manipulate the 
Midi interface, do simple animation 
and control external devices, plus some 
other unrelated stuff. 

You also should be aware that Micro- 
soft has decided that Windows 3.1 
should contain the multimedia DLLs 
but miss some of the multimedia device 
drivers and HyperGuide. This makes 
the Multimedia extensions somewhere 
between 3.0 and 3.1 since you can use 
the DLLs to upgrade 3.0 users. In either 
case, the MDK will be the only place to 
provide an in-depth discussion of the 
API for the multimedia extensions to 
the 3.0 API. 

If you want to be convinced that OS 
developers are only here to persuade 
penniless applications developers to 


[= the word ‘Multimedia’ flabby? 


buy expensive hardware, then the sys- 
tem requirements for the MDK will be 
conclusive proof, There are two levels, a 
Multimedia Programmer (that’s People 
Like Us) requires: 80386+ processor, 
4MB RAM, an 80 MB hard disk, 256 Col- 
our VGA, audio support including 
MIDI and CD-ROM, MS-DOS 3.3+ and 
Windows 3.0/3.1. If you are in the rare- 
fied realms of authoring (where you de- 
sign the text, pictures and sound to 
make a multimedia title) you will re- 
quire in addition: 150 MB hard disk, a 
DAT tape drive for CD-ROM produc- 
tion, a Macintosh II for animation, a col- 
our scanner (probably), audio mixing 
support and Word for Windows 1.1a. 
Phew. 

Microsoft isn’t entirely to blame for 
this petit déjeuner de chien; if you are 
going to make a 600 MB CD-ROM then 
you'll need a 600 MB hard disk, plus re- 


“Land and People 


Hawaii. 5oih state of the 


movable media for sending it to the CD 
mastering factory: probably 9-track 
tape or DAT. The animation problems, 
however, can be laid at Microsoft's 
door. The company bought a read-only 
version of the Macromind Animator 
and ported it onto Windows. If you 
want to construct animation sequences, 
you need a Macintosh - and a powerful 
one at that. On top of this, Macromind 
Animator isn’t especially easy to use 
and, while quite powerful, cannot pro- 
duce the 7om and Jerry quality anima- 
tion expected by some audiences. 


Architecture and API 


The programmer's view of Multime- 
dia comes through the Multimedia Ex- 
tension API, a collection of additional 
functions with a distinct and logical 
architecture. The API is quite simple, 
and won't give experienced pro- 
grammers many problems. 

Figure 2 shows the Multimedia Win- 
dows Architecture. There are two dis- 
tinct levels to the Multimedia Exten- 
sions. The high-level interface consists 
of the Media Control Interface plus a 
few special functions, the low-level in- 
terface contains device driver functions. 
High-level functions are translated to 
the low-level equivalents through the 
Multimedia DLLs. 

Let's start with the high-level inter- 
face Microsoft has provided to control 
external Multimedia hardware such as 
waveform audio, CD audio players and 
videodiscs. This interface, known as the 
Media Control Interface (MCI), revolves 
around a device type for which Micro- 
soft supplies a small selection of dri- 
vers. These devices come in two ca- 
tegories: simple and compound. A 
simple device is one that doesn’t re- 


ands ond numer 


Figure 1 - The Multimedia Viewer USA Tour title 
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client/server application builder. 


PowerBuilder 


PowerBuilder is the most powerful 
and easy-to-use environment for 
building industrial-strength client/ 
server applications. It couples an easy, 
intuitive graphic-user interface with 
your powerful server-based relational 
(SQL) database. 

PowerBuilder takes the best char- 
acteristics of traditional systems and 
combines them with the best features of 
the new Windows-oriented, PC-based 
client/server architecture. 

Traditional development lan- 
guages like C or COBOL either don’t 
address the client/server world or are 
too cumbersome for MIS developers 
concerned with productivity. 

PowerBuilder takes a different 

. approach. It lets you paint applications 
quickly and easily. And when your 
needs change, you alter them in min- 
utes, not weeks. 

Getting started is simple. Power- 
Builder lets you access all of its fea- 
tures from one central location, called 
the Power Panel. Anything you need 
to do is just a mouse-click away, 


ee ee 


I would like to: 

Receive a PowerBuilder Info Pack 
Attend a PowerBuilder Seminar 
Evaluate PowerBuilder 


Name: 


Power Panel 

This is a powerful 
command center for 
the developer, which 
provides easy mouse- 
driven access to the 
entire PowerBuilder 
environment. 


Database View Painter 

Graphic definition ofa view, including 
joins, showing automatically 
generated SQL. 


Pawerltuilder 


Power Panel 


oe # 
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‘Author Data 
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Hie Objects Options Window Help 


Window Painter 
The main component of an application 
shown here with a DataWindow object, 
several PushButtons, RadioButtons,and 
a DropDownListBox. 


UU EL 


Job Title: 


Company: 
Address: 


Tel No: 


Fax No: 
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quire a filename, eg CD audio and vi- 
deodisc players that operate on the in- 
stalled disc. A compound device re- 
quires a filename and an element name, 
such as a file of waveform audio. 

The MCI can be controlled either by 
a command-based interface or a string- 
based interface. Both interfaces support 
the same commands - it is only the pres- 
entation that’s different. The string in- 
terface is like a macro language. The 
programmer can pull in a string from 
the user, stuff it into a long pointer and 
send it to the Multimedia extensions. 
For example: 
dwErrorCode = mciSendString ( 

"play videodiscl to 300", 

NULL, 0 , OL) 
sends the string ‘play videodiscl to 300’ 
to the MCI that plays a videodisc (if 
there is one) from the current position 
to position 300. If an error is returned, 
you can pass it to mciGetError- 
Stxring() fora description of the 
error. If you really want to be lazy, you 
can call mciExecute() witha similar 
string and it will handle the errors for 
you. This approach fits like a head ina 
guillotine for programs that need to be 
extended for multimedia and have a 
macro language, for example Asyme- 
trix Toolbox. 

The command interface is also 
simple, taking a data structure in place 
ofa string. It has three commands: mei - 
SendCommand, mciGetDeviceID and 
mciGetErrorString, of which mci- 
SendCommand is the most important: 
DWORD mciSendCommand (wDeviceID, 

wMessage, dwFlags, 
dwStructure) 

The wDeviceID represents the MCI 
device that you send wMessage with 
he associated data given in the parame- 


Multimedia Application 


High-level Functions 
-mel interface 


Low-level Functions 
-midi, wave 


Low-level Device Drivers 


Figure 2 - 
The Multimedia Windows Architecture 
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typedef struct { 
DWORD 
WORD 
WORD 
LPSTR 
LPSTR 
LPSTR 

} MCI_OPEN_PARMS; 


awCallback; /* callback for MCI_NOTIFY */' 
wDeviceID; /* device ID returned to user */ 
wReserved0; /* veserved for later use */ 
lpstrDeviceType; /* device type */ 
lpstrElementName /* device element */ 

lpstrAlias; /* optional device alias */ 


Figure 3 - The MCI_OPEN_PARMS structure to open a device 


ters dwF lags and the message data 
structure dwSt ructure. This data 
structure varies according to the com- 
mand; the MCI_OPEN_PARMS structure, 
used to open a device, is shown in Fig- 
ure 3. The callback procedure dwCal1- 
back allows you to specify a procedure 
that gets told when the particular action 
has completed. This means that you can 
set a task, such as playing a CD audio 
disc, running in the background and 
get on with something else. When the 
disc has finished, the callback prompts 
the user. 

The MCI language is really not bad - 
see the selection of commands in Figure 
4. Let’s have some examples of using 
the MCI string interface. To play a 
waveform audio file called 
BURP.WAV, you first open it with: 


open \sounds\burp.wav 
type waveaudio 
alias sounds 


(Single line broken up by our narrow col- 
umn width - Ed.) Notice the verbs (open, 
type and alias) and the nouns 
(\sounds\burp. wav, waveaudio 
and sounds). You don’t strictly need 
the type or the alias. The MCI can 
determine the type from the .WAV ex- 
tension, and the alias (equivalent to 
lpstrAlias in MCI_OPEN_PARAMS) 
allows you to use the noun sounds for 
future communication with the file. To 
hear the file 


play sounds 
and to replay and then close the file: 


play sounds from 0 
close sounds 

In addition to the MCI, there are 
some special case high-level functions, 
mostly for controlling waveform audio. 
The two that you'll most frequently use 
are MessageBeep and sndPlaySound. 
MessageBeep has been around since 
Windows version 0, with the single par- 
ameter always unused. Well, now it is 
used; you provide the same constants 
as for MessageBox: MB_ICONAS- 
TERIX, MB_ICONEXCLAMATION 
MB_ICONHAND and MC_ICONQUES- 
TION. These produce sounds depend- 
ent on entries in WIN.INI, which the 
punter can set up via an applet in the 
new Control Panel. The sndPlay - 
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Sound command simple plays a wave- 
form audio file given a filename or 
WIN.INI alias. For example: 


sndPlaySound("MouseClick", 
SND_SYNC | 
SND_NODEFAULT) ; 


plays the sound associated with the 
alias ‘MouseClick’ in the [Sounds] sec- 
tion of WIN.INL 

Finally, Microsoft provides the low- 
level interfaces to each of the device dri- 
vers included in the kit. These consist of 
functions prefixed with midi, wave and 
mmp (Macromind movie player). Why 
would you want to use it when the MCI 
should provide all the control you 
need? The reason is that the MCI has 
some astonishing holes in its repertoire; 
for example you cannot delete or record 
over portions of a recorded waveform. 
Luckily, the low-level interface isn’t too 
difficult to use, 


Potpourri API 


Microsoft has taken the opportunity 
to improve, fix or change some of the 
APIs not obviously associated with 
multimedia. In particular: 


@ Device Independent Bitmap 
Manipulation 

@ Better timer services 

@ Joystick Services 

®@ File I/O Services 

@ Screen Saver API 


The most important is the file I/O 
services, sorry, the multimedia file 1/O 
services. Oh Microsoft: you have al- 
ready brought us MS-DOS, C run-time, 
BIOS and Windows file I/O (or lack 
thereof). Why are you giving us yet an- 
other interface? The given reasons are: 


@ They provide more functionality and 
are easier to use than the MS-DOS. 
Admittedly, not a difficult task. 
They are part of the system software, 
so they don’t increase the size of 
your application like the C run-time 
library. We're scraping the barrel 
here, since most Windows applica- 
tions are > 200 KB. The extra 10 KB 
of file I/O library isn’t going to 
break the bank. Also, if this is the in- 


REALIZER 


The Ultimate Application Development Environment for Windows 


SAVE HUNDREDS 
OF HOURS OF 
DEVELOPMENT 
TIME! 


Realizer combines 
preprogrammed mini 
applications with visual 
Windows designs and code 
generation to provide the most 
powerful development 
environment available. 
Realizer's structured language 
based on a superset of BASIC, 
means that programmers from 
all backgrounds find Realizer 
easy to learn and master. 
While easy to learn and use, 
REALIZER offers advanced 
language features, many not 
available to programmers 
before. 

- Establish triggers and links 
among REALIZER tools. 

- Full support for DDE and 
serial communications 

- Access any Windows API 
functions 

- Access functions from 
languages such as C and Pascal 
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Feature 


Language 


Turbo 
Pascal for 
Windows 


Visual 
Basic 


Realizer 


Non Standard 
BASIC 


Easy to use procedural 
programming model 


Integrated, Non Interfering 


Debugger 


Application delivery 


Form-based user interface 
Automatic code generation 


Additional user interface tools 


Spreadsheet tools 


Text-editing tools 


Event-scheduling tool 


No 
(flowcharts) 


Yes 


Integrated but 
interfering 


EXE with 
runtime DLL 


Integrated but 
Minimal 


EXE with 
runtime DLLs 


Runtime 
DLLs 


EXE with 
runtime DLL 


EXE 
(compiled) 


Charts, 
Graphics, 
Animation 


Graphics 


Board-watch tools 


Graphics tablet tool 


Multiple Document Interface 
(MDI) support 


Encryption of source files 


DLLs, DDE support 


Incorporate standard Windows 
Custom Controls 


High-level database mapping 
layer for back-end independence 


Non - 
standard 


Ao aT 
REALIZER includes: 


Structured Superset of BASIC 


Animation and Graphics 
Full Featured Integrated Debugger 


Gupta's SQLBase Server 
Royalty Free Runtime Compiler 


is 


FORMDEYV - Visual Form Designer and Code Generator 
Programmable Application Tools - Spreadsheet, Chart, Forms, Scheduler 


Full Support for DDE and Serial Communications 
Access to 3rd party Windows engine, such as Borland Paradox Engine or 


Realizer retails at £275.00 plus VAT. You can upgrade from any 
other Windows Development System for just £89.00 plus VAT. 
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A VERY SPECIAL OFFER TO VISUAL BASIC, TURBO PASCAL 
FOR WINDOWS, OBJECT VISION, SUPERBASE 4 OR C and 
SDK PROGRAMMERS 
Realizer normally retails for £275.00 plus VAT, but to prove how easy to use itis, 
simply send us proof of purchase of the front page of your existing development 
system manual and we will upgrade you to Realizer for just £89.00 plus VAT. 


Please send me further information about Realizer: 
Name: 
Address: 


Postcode: Tel: 
Equinox Business Systems Ltd, 148 Shoreditch High Street, London El 6JE 


Equinox Business Systems Ltd 148 Shoreditch High Street, London E1 6JE 


Tel: 071 729 0990 Fax: 071-729 0407 


All trade marks acknowledged. 


EQUINOX 


> CIRCLE NO. 080 


MULTIMEDIA 


tention, why not ship the C run-time 
as a DLL with every copy of Win- 
dows, perhaps saving even more 
space? 

® They provide more functionality 
than the Windows services. But there 
is next to no file I/O in Windows... 


Notwithstanding the illogicality of 
their existence, the Multimedia file 1/O 
services (MMIO) are neat. They provide 
buffered I/O, easy ability to read and 
write RIFF files, memory files and cus- 
tom storage systems. It’s just a pity that 
| they're hidden inside the Multimedia 
__ extensions and aren’t on general re- 
lease. The ability to handle buffered 
files simply and speedily alone justifies 
their use, and compensates for the extra 
baggage of the new API. 

Microsoft has badly needed decent 
timer services in Windows since its in- 
ception, but Windows’ single-threaded 
architecture makes accurate timers a dif- 
ficult problem. Microsoft has hacked 
around this with a controlled use of the 
timer interrupt that calls your DLL call- 
back function at interrupt time. 

The slew of other APIs is rather bor- 
ing. There is a joystick interface (the 
demo tries to liven it up with a name of 
‘JoyToy’), and the addition of direct 
DIB bitmap support. Perhaps the least 
important of the new APIs is the screen 
saver API, but it does provide hours of 
endless fun, particularly with the combi- 
nation of stereo sound, animation and 
full colour bitmaps. 


Multimedia Viewer 


The highlight of the MDK is the 
Multimedia Viewer (which incidentally 
didn’t ship with the betas reviewed in 
other, lesser magazines). Multimedia 
Viewer (hate the name but it’s apt) is a 
much advanced, stand-alone version of 
the Windows Help Engine, just right 
for building ‘electronic books’. Indeed, 
Microsoft has hinted that Viewer (that’s 


of which one will be a new version of 
the Sony Dataman. 

The Viewer works just like the 3.0 
Help Engine. You take an RTF file with 
special, embedded commands; make a 
separate project file; and throw them at 
a compiler that (eventually) gives birth 


Microsoft isn’t 
entirely to blame for 
this petit déjeuner 
de chien 


to a Viewer file. You then run Viewer 
with the file name on the command line 
and lo, you have an electronic book. 
The Viewer differs from the Help Engine 
in that you can call any DLL from the 
Viewer. Microsoft has supplied DLLs to 
do full text searching, waveform audio, 
animation and proper bitmap support 
amongst other things. It really is light 
years ahead of the 3.0 Help Engine. 

This API link is achieved via an em- 
bedded ! command in the text and a 
declaration line in the project file, as 
shown in Figure 5. The example allows 
someone to copy a bitmap (BIRD.DIB) 
to the clipboard using the function Co- 
pyBmp from MVBMP.DLL. This DLL is 
bundled with the Viewer, and controls 
256 colour bitmaps. There are seven 
bundled DLLs in all, including 
MVAFF.DLL for animation (! HAni - 
mat eCommand) and MVAUDIO.DLL 
(1 HAudi oCommand) for waveform audio. 

A DLL must be able to call back to 
the Viewer, so the Viewer has an API of 
its own. This API is powerful; you can 
write a DLL that places an embedded 
window - perhaps a new control or a 
video overlay - within the Viewer’s win- 
dow. The Viewer may be used as an al- 
ternative to the Help Engine, although 
the MVAPI function call has an entirely 
different syntax to WinHelp. 

The Viewer has a number of other 


better) will ported onto other platforms, 
Command Message String Interface 
MCI_OPEN Open 
MCI_LOAD Load 
MCI_PLAY Play 
MCI_RECORD Record 
MCI_SEEK Seek 
MCI_CLOSE Close 
MCI_SAVE Save 
MCI_GETDEVCAPS Capability 


Description 


Initialises an MCI Device. 

Not always needed when using 
the string interface 

Loads data from a disk file 
Starts transmitting output data 
Starts recording input data 
Seeks forward or backward 
Closes an MCI device 

Saves data to a disk file 


Obtains the capabilities of 
an MCI device 


be 


Figure 4 - Some MCI commands 
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neat features. You can place ‘hotspots’ 
ona bitmap and have the Viewer jump 
to the appropriate topic. For example, 
ona picture of a book-shelf you click on 
a book and jump to its contents. The 
Viewer also allows the author to mod- 
ify the menu system of the Viewer to ex- 
ecute, for example, an external applica- 
tion. Finally, the Viewer also provides 
If-Then-Else statements to allow for 
simple conditional expressions. 

In spite of my enthusiasm for the 
Viewer, there are several rough points. 
The main one is that it is incompatible 
with Microsoft Windows Word Version 
2.0. This is a real bummer, since Micro- 
soft insists that you use Microsoft Word 
to create the Viewer title. A fix has been 
promised, but has not materialised at 
the time of writing (‘Real Soon Now’). 

Once this is sorted, perhaps they 
should look at the ridiculously slow 
speed of the compiler. It’s even slower 
than the tortoise-like 3.0 Help Engine. 
Finally, Viewer doesn’t really like differ- 
ing screen resolutions or fonts. Viewer 
titles will only work perfectly at one 
screen resolution, typically VGA, and 
rely on the base set of fonts that come 
with Windows. 


Tools and Docs 


The MDK comes with several tools 
to manipulate the Multimedia formats. 
You get: 


@ Convert. A utility to change one file 

format to another; usually convert- 

ing to an MS standard equivalent. 

BitEdit. A simple bitmap editor. 

PalEdit. A palette editor 

WaveEdit. A waveform audio editor 

and recorder. 

@ FileWalker. A hex file editor that 
knows the structure of certain Micro- 
soft standard files. 


The tools are up to the usual Micro- 
soft standard as supplied with the Win- 
dows 3.0 SDK - they won't frighten 
ZSoft or Voyetra. The two best are Con- 
vert, which uses the Aldus/Microsoft 
standard file filters that come with Page- 
maker and WinWord 2.0, and FileWal- 
ker, a superior hex editor. 

Convert includes bitmap conver- 
sions such as Apple Macintosh PICT, 
Compuserve GIF, HPGL and EPS, 
audio conversions such as Apple AIF 
and the MIDI conversion includes the 
standard MIDI file format. FileWalker 
uses a novel way to view a binary file as 
an outline of structures rather than as a 
hex dump. This makes it much easier to 
view and edit structured binary files, and 
one wonders whether some bright indi- 


vidual might extend it to other file for- 
mats, such as WK1 and dBASE. 

The MDK comes with six manuals: 
Getting Started, Programmer's Workbook 
(an API tutorial), Programmer's Reference, 
Multimedia Authoring Guide, Data Prepara- 
tion Tools User's Guide and the Multimedia 
Viewer Developer's Guide. The Viewer 
guide is about the same size as the Pro- 
grammer’s Reference, which gives you 
an idea of the complexity of the Viewer 
and the simplicity of the API. The Data 
Preparation Tools User's Guide gives de- 
scriptions of the tools that come with 
the MDK, and will remain on some 
dusty shelf. The Multimedia Authoring 
Guide tells you about the data problems 
you'll encounter, eg where do you put 
600 MB of CD-ROM data? 

On the whole, the MDK documenta- 
tion is to the high standard we expect of 
Microsoft, although I really wish they 
would put examples in their reference 
manuals, and cover some areas in 
greater depth. 

Microsoft ships several examples 
with the MDK. The best of these is the 
18 MB of Viewer example called USA 
Tour (see Figure 1). This presents a pic- 
ture of the USA and gives factual infor- 
mation on the most interesting of the 50 
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Text: 


{bmc usclip.bmp}!CopyBmp(hwndContext, qchPath, "bird.dib") 


Project file: 


(CONFIG] 
RegisterRoutine("mvbmp", "CopyBmp", 


"vsUSS") 


Figure 5 - Creating a Viewer API link 


states. You are given the full source 
code in the form of RTF files, BMPs, 
Make scripts, project files and Setup 
program, so you can see the tricks in- 
volved in building a real title. Bravo 
Microsoft! In contrast, the few other 
examples for the API are anaemic. 

The MDK also comes with an on-line 
help system in 3.0 Help Engine and 
Viewer formats. There are actually two 
separate systems: one containing the 
MCI commands, the other containing 
the API. This is extremely inconvenient: 
you need both the SDK help system 


plus the multimedia system open at.the ~ 


same time. With such vast acres of stor- 
age on the CD-ROM, why couldn't Micro- 
soft just combine the lot into one title? 


Conclusions 


Thave had great fun with the MDK. 
My formerly boring programs became 
alive with weird sounds, and I fright- 


ened the neighbours with the disgusting 
noises of my screen savers. The MDK can 
produce programs that can truly excite 
people to want to use a computer. 

Asa kit, however, the MDK is a very 
flash box with some very drab contents. 
What swung me in its favour was the 
inclusion of the Viewer. The Viewer is a 
genuinely useful tool that makes it easy 
for developers to build electronic books 
with limited interactivity. Overall, for- 
get the cost and rough edges, just go 
out and have fun with the MDK. 


Jeffrey Goldberg is a multi-talented pro- 
grammer who has worked for big names like 
Borland and Psion, and who omitted to sup- 
ply us with a biog so is going to have to put 
up with this. He is cricket on CIX. 


The MDK costs £335 from Microsoft 
Sales (0734 270000). A free upgrade for 
Windows 3.1 should be available from the 
end of May. 
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HEAVY WINDOWS 


Windows - How to 
break all the rules 


Now that you've mastered ordinary Windows 
programming, time'for something a little more taxing... 
Microsoft’s David Thielen begins a new series with a 
marathon description of VxDs. 


irtual device drivers (VxDs) are 
\ ] not just for people writing dri- 

vers for hardware devices any 
more than DOS device drivers are. 
VxDs are Windows’ way of letting you 
do anything you want. If you miss the 
DOS world where you can break any 
rule, hack any code, take over any part 
of the operating system, then welcome 
to VxDs where you can do the same 
thing in Windows. 

So if VxDs aren't just device drivers 
then what are they? A VxD is code that 
is run at ring 0 in flat 32-bit model as 
part of the Win386 Virtual Machine 
Manager. In fact, the Win386 Virtual 
Machine Manager (WIN386.EXE) is pri- 


marily a number of standard VxDs that 
have been copied into one file. (VxDs 
are only run when Windows is running 
in 386 enhanced mode.) 

Win386 is not really even part of 
Windows. Win386 is a pre-emptive 
multi-tasking kernel that controls 
multiple virtual machines. Once 
Win386 has initialised itself, it then 
loads Windows in the system VM (the 
main virtual machine that always 
exists). However, it could just as easily 
load COMMAND.COM instead and 
you would then have a multi-tasking 
DOS. (No, I won't tell you how to do 
this.) 

So what does this give us? Well, 
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since we run at ring 0, we are at the 
operating system level of protection; 
the 386 chip will allow us to use any in- 
struction. At the higher levels (rings 1 - 
3) more and more instructions are off 
limits or will fault, so that a VxD can 
virtualise them. While there are actions 
a VxD should not take, such as move 
the Interrupt Vector Table (IVT), and 
while you do need to worry about 
crashing Windows, you will not be 
stopped. 

A VxD is always active, unlike any 
other part of Windows, If a DOS box is 
running in exclusive mode, then the 
only thing executed aside from the DOS 
box itself are any VxDs responding to 
IRQs, timers, or code that is called due 
to the code executing in the DOS box 
(such as watching an interrupt). 

A VxD is the only program that truly 
touches the hardware. If a VxD talks to 
a port, it is talking to the physical port 
and nothing else gets in the way or 
slows it down. If a VxD owns a hard- 
ware interrupt (IRQ), it receives the 
hardware interrupt directly and quickly 
with no ring transitions. Where code 
talking to hardware from DOS or Win- 
dows is slow, a VxD is fast. 

Since we are ina flat 32-bit model, 
we are in the 386 equivalent of small 
model. All of the segment registers are 
fixed to the same value. (The CS regis- 
ter is different so that it is a selector to 
code instead of data but it points to the 
same memory.) Because a VxD runs in 
protected mode, all offsets to data and 
code are 32-bit. Therefore, you can ac- 
cess any part of memory (all 4 giga- 
bytes) with just an offset. 

While different DOS boxes and Win- 
dows programs each have their own 
memory, the flat 32-bit model of a VxD 
includes all the memory of all existing 
programs. A VxD can read from or 
write to the memory of any existing pro- 
gram. 

A VxD is also given first priority on 
all actions in a system. A VxD can inter- 
cept and/or generate interrupts (hard- 
ware or software), port I/O, and even 
memory access to specific regions of 
memory. If a VxD intercepts an inter- 
rupt or port I/O, it can decline to pass it 
on, and the program it was intended for 
will never know the interrupt occurred. 

VxDs exist only in the 386 enhanced 
mode of Windows. They are based on 
the system level capabilities of the 
80386 and therefore this article assumes 
you have a decent understanding of the 
80386. 


What are they for? 


So what do we do with this power? 
First, be careful. If you write a bad DOS 
app, you will usually just trash the DOS 
box you are running in. If you write a 
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bad Windows app, you may trash an- 
other Windows app as well. If, how- 
ever, you write a bad VxD, you will 
trash the entire system. 

This is important enough to repeat: 
You are adding to the WIN386 kernel. 
In almost all cases, you will be involved 
almost constantly in the operation of 
Windows. The smallest, most subtle 
bug can cause serious harm in this situ- 
ation. Don’t just test that your VxD will 
do what you want, but that it will not 
cause harm when other programs are 
doing what they want (ie spend at least 
5 minutes testing). 

Make sure you follow the rules. You 
can do whatever you want - but if you 
do, you will find that your VxD doesn’t 
work very well in many configurations 
(remember the early days of TSRs). It 
takes more work, but in virtually every 
case you will find that you can write a 
VxD that follows the rules and accom- 
plishes what you want. 

The initial purpose of VxDs was for 
actual hardware devices. When two or 
more programs want to talk to the same 
physical device, you have two ways 
you can virtualise it. Preferably, you 
can use your VxD to appear to each pro- 
gram as though they have exclusive ac- 
cess to the device. An example of this is 
the printer port. Every program should 
be given a virtual printer port and char- 
acters written to the port should ac- 
tually be sent to the print spooler. (No, 
Windows doesn’t do it this way but a 
third-party app called Win-Link does.) 
Under this system, all programs see the 
printer - yet they do not interfere with 
each others’ output. 

The second method is to assign the 
device to only one program. If another 
program wishes to access the device, 
the VxD should act as though the de- 
vice is busy and not pass the request on 
to the actual hardware. An example of 
this is the serial port. Two programs 
cannot dial up through one modem sim- 
ultaneously. 

If at all possible, a VxD should vir- 
tualise a device using the first method. 
It’s much more user-friendly to make a 
device available in each Virtual Ma- 
chine. While it may take some extra 
work, it’s worth it to the end user and 
sometimes all it takes is a little creativ- 
ity. For example, if a system has access 
to a modem pool over the network, 
then using that modem pool, a VxD 
could make it appear that a modem is 
available on COM1 in multiple DOS 
boxes simultaneously. 

Many times, the overhead of fully 
virtualising a device makes the first 
method too slow. For example, virtualis- 
ing a printer port could probably be 
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done for a 12 page/minute (ppm) 
printer but not for a 60 ppm printer 
when a program prints directly to the 
printer ports. In this case, you would 
want to use the second method and as- 
sign the device. However, if you do 
this, do create an API for direct calls 


If you miss DOS, 
where you can break 
any rule, hack any 
code, take over any 
part of the OS - 
welcome to VxDs 


that virtualise the device. In the case of 
the printer port, have your VxD pro- 
vide an API that programs can call to 
write 1 characters to the printer. The 
VxD could then pass this on to the Win- 
dows spooler. \ 

One final note on VxDs for acttial 
hardware devices. A number of ven- 
dors of non-standard hardware devices 
(fax cards, scanners, etc) don’t write 
VxDs at all; they depend on only one 
program accessing the system at a time. 
This is unacceptable. Not only can this 
crash any application using the hard- 
ware, but it also makes numerous as- 
sumptions about Windows, which are 
generally, but not always, true. Finally, 
a VxD can handle the low-level com- 
munication with the hardware a lot 
more efficiently than a Windows or 
DOS app can. 

So if you build a hardware device, 
you have three choices: 1) Truly vir- 
tualise the device (excellent); 2) Allow 
only one app at a time to access the de- 
vice (not so good but sometimes the 
best alternative); and 3) Ignore the prob- 
lem and hope it will resolve itself (unac- 
ceptable), Windows is maturing quick- 
ly. Make sure that the VxDs for your de- 
vice don’t get left behind. 


VxDs sans hardware 


What if you don’t build hardware 
but you’re still anxious to play with this 
new toy (VxDs)? Well, what have you 
wanted to get done that Windows 
wouldn’t let you accomplish? Where 
Windows tells you no, a VxD says yes. 
That’s where you can use it. 

One good example is Inter-Process 
Communication (IPC). With a VxD, ap- 
plications in DOS boxes can post mess- 
ages to apps in other DOS boxes or to 
Windows apps. The call PostMessage 


has been written so that it can be called 
asynchronously. (SendMessage can’t, 
so don’t try this with it.) A VxD can 
post a message to any window at any 
time. 

Keep in mind that each Windows 
app has a message queue of limited size 
and once you fill it up, you cannot post 
any additional messages until some of 
the messages in the queue have been 
processed. Because the existing mess- 
ages will not be processed until Win- 
dows receives the CPU, you cannot 
wait for the queue to empty out. Gener- 
ally, you need to-post-a.single message, 
and wait fora-call back from the reci- 
pient of the message before posting an- 
other message. 

A VxD can give a Windows app a se- 
lector that points to memory anywhere 
on the machine. Through this medium, 
a Windows app can access the memory 
in a DOS box. A DOS box cannot do the 
reverse since it uses segments instead of 
selectors. However, this still leaves a 
pool of common memory for DOS and 
Windows applications to share. 

Another example is accessing a hard- 
ware card over the network. In the sim- 
plest case, an I/O card is accessed by 
reading and writing to one port. A VxD 
on the client system can trap all in and 
out calls to the port. The VxD then 
sends these requests over the network 
to the server system. The server VxD 
will then make the actual ‘in’ or ‘out’ in- 
struction to the card. If the instruction 
was an ‘in’, the server VxD will then 
pass the result back to the client system, 
which will in turn return the result to 
the calling program. By using this 
example, a card and software that re- 
quire local access can be used over the 
network with both the card and access 
software believing that they are both on 
the same machine. (I would not recom- 
mend actually doing this, as it would be 
very slow). 

When the Norton Desktop for Win- 
dows was written, the developers 
wanted to write the program in 32-bit 
flat model, so they wrote most of the 
program as a VxD. The VxD makes 
calls to a small Windows program they 
also wrote which then makes calls to 
the Windows API when needed. How- 
ever, the vast majority of the program is 
a VxD. 

By the way, if you want to write a 
flat 32-bit program, a better solution is 
to use the new library coming from 
Metaware (which should be out by the 
time this article is published). This 
gives you a regular Windows program 
that is written in flat 32-bit model by 
using the BIGMEM.DLL file included 
with Windows 3.x. This way you re- 
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main a Windows app instead of becom- 
ing a VxD just to be 32-bit flat. 

There are a million more examples: 
sitting on disk I/O for encryption, 
multi-threaded Windows applications, 
true Windows TSRs, and more. A good 
example is Win-Link from Celtic Soft- 
ware (written by the author) which pro- 
vides IPC and shared memory between 
DOS boxes and Windows applications, 
launches Windows apps and DOS 
boxes from DOS boxes, sends all DOS 
box printing to the Windows spooler, 
and puts the name of the running DOS 
app in the title of the DOS box. This is 
all possible through the magic of VxDs. 


The Virtual Machine Manager 


Between the VxDs and the actual 
hardware is the Virtual Machine Man- 
ager (VMM). This is composed primar- 
ily of a number of base VxDs which vir- 
tualise the basic hardware of the CPU, 
memory, interrupts and ports. And 
even at this low level, you can write a 
VxD to replace one or more of these 
parts (although I would strongly recom- 
mend against it). 

The VMM also creates, runs, and de- 
stroys the Virtual Machines (VM). On 
start-up, the VMM creates the system 
VM. The system VM always exists - it 
holds all of the Windows applications. 
Each DOS box is a VM running in Vir- 
tual 8086 mode (V86). A VxD, because 
it is part of the system, runs in what- 
ever VM it was called from. Therefore, 
when a VxD is called from a DOS box, 
it is running in protected mode in that 
DOS box’s VM. 

The following discusses each of the 
parts of the VMM. To write a VxD it is 
critical that you have a clear under- 
standing of these pieces. It will not only 
give you a better idea of the possi- 
bilities available with VxDs but will 
also give you a better idea of how to de- 
sign your VxD. While Windows does 
have more than its share of bugs, I have 
yet to find a bug in WIN386 (although 
I’m sure some do exist). If you follow 
the rules, you should be ok. 


Scheduling 


The scheduler rotates CPU time 
among the DOS boxes and the system 
(Windows) VM. The scheduler uses the 
VM priorities to decide which VM will 
run next and for how long. This is done 
using two properties; the time-slice 
priority and execution priority. 

The time-slice priority is the fore- 
ground and background priorities that 
you see in the .PIF file of a DOS app. 
These values are used to determine 
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what percentage of the time a given VM 
should get the CPU, and control how 
much a VM's execution priority is in- 
creased. When a VM finishes its time 
slice, the VM with the highest execution 
priority is run next. When a VMs time 
slice has completed, its execution 
priority will then be dropped so that an- 
other VM can run. 

The time-slice priority is used to ad- 


If in doubt, use a 
swapable segment. 
Thrashing the disk is 
not as serious as 
running out of 
physical memory 


just the execution priority, which de- 
cides who runs next. The time-slice 
priorities generally stay constant while 
the execution priority is constantly 
changing. When switching between 
VMs, the VM with the highest execu- 
tion priority will always be scheduled 
next, The execution priority of a VM 
can be temporarily boosted to insure it 
is scheduled next. You should never 
need to change these values except for 
temporary boosts when requesting 
events (discussed below). Make sure 
you always do a temporary boost - a per- 
manent boost will change the time-slic- 
ing behaviour of the system. 

Along with VMs, you also have IRQs 
and timer events. When an IRQ or 
timer event occurs, a handler function 
is called as soon as possible. This is an 
asynchronous event (covered further 
down). These events can happen at any 
time. Aside from these events, all sche- 
duling occurs by switching to the VM. 
with the highest execution priority. 

The scheduler also implements Sema- 
phores. (Note: Don’t use Semaphores in 
Windows 3.0. They are not supported 
and can never unlock in certain cases.) 
On each Wait_Semaphore, a counter 
will be decremented. If the counter is 
decremented below 0, the caller will 
block until the counter is raised back to 
0 by a call to Signal_Semaphore. If 
you need to wait until something oc- 
curs, this is the way to do it. The 
blocked VM will not be scheduled re- 
gardless of its execution priority. 

When a VM is unblocked, it will 
then be scheduled as soon as its execu- 
tion priority is highest. This will usually 
be immediate since while it was 
blocked, its execution priority has been 
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raised. (‘Immediately’ meaning the 
blocked process will generally be run 
before Signal_Semaphore returns). 
Several VMs can block on the same se- 
maphore. While the last blocked will 
usually be the first unblocked, this 
doesn’t always happen - so don’t de- 
pend on it. 

Since a semaphore blocks a VM from 
executing, the only way to unblock a se- 
maphore is from another VM or from 
an IRQ or timer event. A requested 
event (see below) will not occur ina 
blocked VM because it is part of the VM 
and therefore blocked. The primary 
uses of semaphores are: 1) Allow only 
one VM ata time access to a function, 2) 
To block until an IRQ or timer event oc- 
curs; and 3) To stop reéntrancy from 
multiple IRQ or timer events occurring 
on top of one another. 

The scheduler also implements a 
critical section. The critical section can be 
claimed any number of times by a 
single VM (and needs to be released the 
same number of times) without the VM 
blocking. However, if one VM has 
claimed the critical section, then an- 
other VM will block if it claims the criti- 
cal section and will not be unblocked 
until the first VM has released it. 

The critical section exists primarily 
because of DOS. You should never need 
to use it but you have to be aware of it. 
Many of the VMM calls claim the criti- 
cal section. Therefore, if your VM does 
not hold the critical section and another 
VM does, when you make a VMM call 
you may block. 


Event Processing 


The Windows VMM is a single- 
threaded, non-reéntrant operating sys- 
tem. While in your VxD, you have ex- 
clusive control of the system until you 
yield; just as in DOS. However, asyn- 
chronous hardware interrupts wait for 
no VxD. If the timer ticks, the serial port 
receives, or the mouse moves, then that 
IRQ must be serviced immediately. The 
Event Processor will pause the execu- 
ting thread and call the VxD IRQ hand- 
ler. On return it will continue executing 
the thread it was on. 

Because the VxD was called on an in- 
terrupt (interrupting who knows what; 
another VxD, a Windows app, DOS 
etc), there are only a limited number of 
actions that can be taken. Generally the 
information associated with the IRQ 
will be read/written into/from a buffer 
and an EOI sent. The VxD will then reg- 
ister an event address and return. 

When an event is registered, its ex- 
ecution priority can be set (this is called 
a temporary boost). If set to a higher 


priority than any other VM, then the 
event address will be called on the next 
task-switch. There are also calls request- 
ing a call-back after a certain amount of 
time, when a specific VM is running, 
when nothing is happening etc. In each 
of these cases, an event address is 
passed as well as an adjustment to the 
execution priority. In all of these cases 
you are registering an event which will 
be called back when the system is in an 
acceptable state for the event handler. 
This is know as Event Processing. 

Because it is the execution priority 
(rather than the time-slice priority) that 
is adjusted, once the call-back has com- 
pleted, it will return to its normal 
priority set by the time-slice priority. Be- 
cause a VxD is not time-sliced, it will 
run without interruption (except for 
IRQs) until it has completed. 

If an event is set as VM specific (as 
opposed to global), then it will not be 
called back until that VM is about to get 
a time-slice. If another VM is running in 
exclusive mode, then a call-back to a 
specific VM may not happen for a long 
time. Therefore, if it is important to 
handle an event quickly, you may want 
to set your call-back as global instead of 
VM specific. 

Another concern is if you will be 
making calls that claim the critical sec- 
tion, then it is necessary to have your 
call-back come back in the VM that 
holds the critical section, In this case 
you either want your call-back to occur 
when the critical section is not claimed 
or you want to be called in the VM that 
owns the critical section. In some cases 
DOS is waiting for your code to finish 
something and therefore the critical sec- 
tion will stay claimed until your call- 
back occurs. This will lead to deadlock 
if you set your event to occur ina VM. 
other than the one holding the critical 
section. 

Be very careful how you set up your 
call-backs. If you think through all 
possibilities you will generally find that 
you need to do it one specific way. 
Also, make sure your method will work 
if another VM is running in exclusive 
mode. If you set up an event and it 
never occurs, you have probably dead- 
locked. 


Ring Transitions 


We have the VMM, VxDs, Windows 
programs, DOS programs and hard- 
ware interrupts. So how does the CPU 
make transitions between these differ- 
ent pieces of the system, running in dif- 
ferent modes (DOS in V86, Windows 
apps in PM16, and VxDs in PM32)? 
Simple; it’s magic. 
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Actually, this is all handled by the 
VMM through interrupts. When an ap- 
plication (Windows or DOS) needs to 
calla VxD, they actually execute a HLT 
instruction. This causes the CPU to 
generate an illegal instruction interrupt. 
On I/O toa protected I/O port, the 


Win386 could just as 
easily load 
COMMAND.COM, 
and you would then 


have a multi-tasking 
DOS 


CPU will generate an interrupt. The 
timer tick and other hardware inter- 
rupts are also pointed at the VMM. 

If there are any outstanding events 
pending, they are handled before re- 
turning to the presently executing task. 
It is highly unlikely that a VxD will 
need to worry about a ring transition. 
Generally, if you trace into a call that 
will cause a ring transition, you will see 
a HLT instruction (which causes an in- 
valid op-code interrupt). VMM takes it 
from there. 

Usually you will find yourself need- 
ing to call code ina VM from a VxD, 
even if it’s something as simple as a 
DOS call. This is done with a combina- 
tion of calls. First, before making any 
calls, you need to call 
Begin_Nest_Exec. A single call to 
this is sufficient before making any 
number of calls to the VM. This call sets 
up the VMM so it can call back to the 
code in the VM. 

This does NOT give you the capa- 
bility to re-enter code that does not ex- 
pect to be re-entered (like DOS). It mere- 
ly allows you to call code in the VM. 
However, if you are intercepting int 
21h, when you get the int 21h call DOS 
has not yet been entered, so you can call 
DOS at that time. 

The VMM provides a number of 
Simulate_*, Build_*, etc calls. 
When you make any of these calls, no 
call, interrupt or whatever is actually 
made. Instead, these calls adjust the 
stack created by Begin_Nest_Exec so 
that these calls will occur before the 
VxD returns to the VM. Then, when a 
Resume_Exec call is made, the VMM 
uses the values on the stack to start ex- 
ecuting the VM again. In most cases 
you set up the Simulate_* calls so 
that, after making the calls to the VM, 
execution will return to the VxD. 


When you make a call into a VM, it 
is the same as though the VM was nor- 
mally executing and no special rules 
apply. While you are ina VxD you are 
the only code executing except for IRQs 
and timers. But while the VM is execu- 
ting calls you have made to it, it may be 
switched to another VM and your VxD 
may even be called again. 

While the above gives you a way for 
a VxD to call a DOS or Windows appli- 
cation, there are also times when you 
want to call a VxD from DOS or Win- 
dows. This is handled with an int 2Fh 
call. A call to int 2Fh with ax=1684h 
by a DOS or Windows application will 
return a far call address in ES: DI, The 
DOS or Windows app can then make a 
far call to this address. You must have 
functions in your DDB (Device Descrip- 
tor Block - discussed below) for this to 
work. If you do not have a function in 
the DDB, the int 2F call will return a 
null address. It is generally not a good 
idea to call the returned address if this 
is returned. 

The VMM will then transfer control 
to the address in the DDB. There are 
two addresses in the DDB; one for real 
mode programs (DOS) and one for pro- 
tected mode programs (Windows & 
DPM)). This way you know if the 
passed-in pointers are segments or se- 
lectors. In this function, when you are 
done you do a ret and the VMM will 
then return to the caller. On the call the 
registers are all pushed and passed to 
the VxD. The VxD can then change 
these register values on the stack to re- 
turn information. 

Aside from the registers on the stack, 
no information can be passed. In almost 
all cases pointers will need to be con- 
verted to flat 32 model. The best 
method to pass more information is for 
the caller to pass a pointer to memory 
and for the VxD to read and write that 
memory. For protected mode pointers, 
you can either use them as is (in which 
case you will have to set and restore 
segment registers) or call Selector- 
MapF lat to convert the address into a 
flat-32 offset. For DOS boxes, you use 
the CB_High_Linear of the VM 
handle to get the base of the VM’s mem- 
ory and then add the real mode ad- 
dress. While you can access DOS box 
memory in low memory, this isa VERY 
bad idea and there is no reason to do so. 


I/O Emulation 


This is handled very simply with a 
call that registers a function to be called 
whenever a specific port is accessed. 
The call-back function is called when an 
application accesses the port, and the 
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VxD can then act on the call, including 
accessing the physical port. The call- 
back function then returns to the VMM, 
which returns to the calling application. 

In the case of printing to the printer 
port, the port would never actually be 
accessed. Instead, an OUT is passed to 
the Windows spooler and an IN always 
returns that the printer is ready. 

The critical thing to keep in mind 
here is speed. If an app is printing a 100 
KB file by writing it a byte at a time to 
the printer port (quite common), your 
function will be called 100,000 times. It 
needs to be fast. In the case of a printer 
spooler, you would save the bytes ina 
buffer and copy the buffer to the 
spooler when it is full. 

Finally, when a VxD does an IN or 
OUT, it goes directly to the port. Be 
careful that you don’t play with ports 
that don’t belong to you. Regardless of 
who owns a port, your port I/O will go 
directly to the hardware, no exception 
will be raised, and the owner of the port 
won’t even know you hit it. 


Interrupt Handling 


Interrupts fall into two categories: 
software and hardware. Software inter- 
rupts are handled the same as I/O 
ports. A VxD can register a function to 
be called when an interrupt call is made 
and can then change the interrupt par- 
ameters and tell the VMM to pass the in- 
terrupt on or that the VxD handled it. 

For hardware interrupts, the VxD 
must ask the VPICD if it can handle the 
IRQ. It also tells the VPICD if it is will- 
ing to share the IRQ. A VxD will only 
be given an IRQ if no one else has it or 
if the VxD that already has it will share 
and your VxD will share also, Sharing 
is important not only to the other VxD 
but to you too if you are asking second 
and the other VxD already has the IRQ. 

Once the VMM has been called by an 
interrupt, it then looks at the interrupt 
to see what it should do with it. Ifa 
given port or interrupt is not watched 
by any VxD, then it is passed through 
to the proper VM. If one or more VxDs 
are watching, then it is passed to them, 
starting with the one that registered last 
and moving forward. Each watching 
VxD is called and, on return, the VxD 
can change the passed values and then 
tell the VMM to either pass the call on 
to the next VxD or that they handled it. 

If you received exclusive access of a 
hardware port, then you will get the in- 
terrupt directly. If you are sharing a 
hardware port, then you will be called 
by the VPICD. In the case of software in- 
terrupts, you are called by the VMM 
(software interrupts are always shared). 
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The last to claim an interrupt is given it 
first. After acting on the interrupt, you 

can then allow it to be passed on or tell 
VPICD/VMM that you handled it and 

not to pass it on. 


If an app is printing a 
100 KB file one byte 
at a time, your 
function will be 
called 100,000 times 


If you do not write a VxD to handle 
interrupts, the VPICD device will sche- 
dule an event and then call the appro- 
priate DOS box or Windows driver 
when the event occurs. Obviously, this 
is a lot slower and is why many hard- 
ware devices will not run under Win- 
dows. 


Memory Management 


The Memory Manager (MMGR) has 
several responsibilities. First, all mem- 
ory in the system is allocated by the 
memory manager. This includes large 
allocations for VMs as well as a small 
heap available to VxDs that need dy- 
namic memory allocation. 

The MMGR is responsible for hand- 
ling virtual memory; copying to and 
from the swap file as necessary. This is 
what allows a system with 2 MB of 
physical memory to have 16 MB of 
memory available to Windows and 
DOS apps. 

While each DOS box has its own 
memory and linear address space, 
whichever DOS box is presently execu- 
ting is ALSO mapped into the low 1 
Meg of the linear address. The MMGR 
does this mapping on each task switch. 

The MMGR handles instance data for 
DOS boxes. Instance data is data that is 
kept separate for each VM (due to the 
fact that DOS was designed as a single 
tasking O/S). This instance data occurs 
in multiple places in DOS and some 
TSRs. (When Windows starts, a TSR 
can give Windows a list of instance data 
- which should be /ul/y contiguous for 
performance reasons). 

It would be very time consuming to 
copy all of the instance data on each 
task switch so the memory manager 
merely marks pages holding instance 
data as not there. Then, if the page is ac- 
cessed, a page fault occurs, and the in- 
stance data in that page is copied in be- 
fore marking the page accessible. 
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The MMGR also can provide ‘in- 
stance’ data to a VxD. Because the term 
instance data is used to describe the 
DOS per-instance data, this is know as 
Control Block data. When you initialise 
a VxD, you can request n bytes of con- 
trol block data. The MMGR will return 
a pointer. The memory this points to 
will be different memory for each VM, 
making it easy to keep some per/VM 
data. 

The MMGR also has an API transla- 
tion service. While registers are 
preserved when making a ring transi- 
tion between V86 mode and flat 32-bit 
mode, a pointer using a real mode seg- 
ment:offset is useless in protected 
mode. The MMGR has a script lan- 
guage that will convert the parameters 
of most calls automatically. 

There are several way of viewing 
memory; flat 32-bit, physical address, 
16-bit selector, or segment. The MMGR 
has calls to convert between all of these 
addresses, It also allows you to lock 
down memory, which is generally 
needed for DMA access. 

You can also view the ‘accessed’ and 
‘dirty’ status bits for each page. The dis- 
play device grabber uses these bits to 
determine if the video memory has 
been accessed and uses that to know 
when a DOS screen in a windowed 
DOS box needs to be updated. 

The low memory (interrupt table, 
BIOS and DOS data etc) for each VM is 
located high along with the rest of the 
memory for that VM. When a VM is 
running, it is also mapped down low. 
While you can access this low memory, 
you are better off accessing it high. The 
high location will not change but when 
the current VM is switched and another 
VM is running, the low address will no 
longer be valid. 


Other Services 


There are a number of miscellaneous 
services. Some are specific to specific de- 
vices (mostly the display device) and 
those will not be covered here. During 
initialisation, there are calls soa VxD 
can access .INI files for set-up informa- 
tion. There are a small number of calls 
to the shell allowing a message box to 
be put up on the screen. This is used 
mostly when a second app wants to ac- 
cess a device that another app already 
has. 

There are also calls to the VPICD 
(Virtual Programmable Interrupt Con- 
troller Device) and VDMAD (Virtual 
DMA Device) that you will find your- 
self using if you are going to be hand- 
ling IRQs or performing I/O using 
DMA. 


Unleash 32-bit Power! 


WATCOM C9.0/386 lets you exploit the two key 32-bit 
performance benefits. The 32-bit flat memory model 
simplifies memory management and lets applications address 
beyond the 640K limit. Powerful 32-bit instruction processing 
delivers a significant speed advantage: typically at least a 2x 
speedup. 


You Get: 
100% ANSI and SAA compatible: C9.0/386 passes all Plum Hall 
Validation Suite tests 


Extensive Microsoft compatibility simplifies porting of 16-bit code 


Royalty-free run-time for 32-bit DOS, Windows and OS/2 apps 
Comprehensive toolset includes debugger, linker, profiler and more 
DOS extender support for Rational, Phar Lap and Ergo 
Run-time compatible with WATCOM FORTRAN 77/386 


32-bit DOS support includes the DOS/4GW 32-bit DOS extender by 
Rational Systems with royalty-free runtime license 
Virtual Memory support up to 32Mb 
32-bit Windows support enables development and debugging of 
true 32-bit GUI applications and DLL's. 
Includes licensed Microsoft SDK components 
32-bit OS /2 2.0 support includes development for multiple target 
environments including OS/2 2.0, 32-bit DOS and 32-bit Windows 
Access to full OS/2 2.0 API including Presentation Manager 
Integrated with IBM Workframe/2 Environment 
AutoCAD ADS and ADI Development: Everything you need to 
develop and debug ADS and ADI applications for AutoCAD Release 11 


Novell’s Network C for NLM’s SDK includes C/386 
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The Industry’s 
Choice. 


Autodesk, Robert Wenig, Manager, AutoCAD for Windows: 
“At Autodesk, we're using WATCOM C/386 in the development 
of strategic new products since it gives us a competitive edge 
through early access to new technologies. We also highly 
recommend WATCOM C/386 to third party AutoCAD add-on 
(ADS and ADI) developers.” 


Fox Software, David Fulton, President: “FoxPro 2.0 itself is 
written in WATCOM C, and takes advantage of its many superior 
features. Optimizing for either speed or compactness is not 
uncommon, but to accomplish both was quite remarkable.” 


GO, Robert Carr Vice President of Software: “After looking at the 
32-bit Intel 80x86 tools available in the industry, WATCOM C was 
the best choice. Key factors in our decision were performance, 
functionality, reliability and technical support.” 


IBM, Jobn Soyring, Director of OS/2 Software Developer Programs: 
“IBM and WATCOM are working together closely to integrate these 
compilers with the OS/2 2.0 Programmer’s Workbench.” 


Lotus, David Reed, Chief Scientist and Vice President, Pen-Based 
Applications: “In new product development we're working with 
WATCOM C because of superior code optimization, responsive 
support, and timely delivery of technologies important to us like 
p-code and support for GO Corp’s. PenPoint.” 


Novell, Nancy Woodward, VP and G.M.,, Development Products: 
“We searched the industry for the best 386 C compiler technology 
to incorporate with our developer toolkits. Our choice was 
WATCOM.” 


The Leader in 32-bit Development Tools 


415 Phillip Street, Waterloo, Ontario, Canada. Telephone: (519) 886-3700, Fax: (519) 747-4971. * Price does not include freight and 
taxes where applicable. Authorized dealers may sell for less. WATCOM C and Lightning Device are trademarks of WATCOM Systems 
Inc. DOS/4G and DOS/16M are trademarks of Rational Systems Inc. Other trademarks are the properties of their respective owners. 
Copyright 1992 WATCOM Products Inc. 


> CIRCLE NO. 086 


The VxD Segments 


Each VxD is composed of several seg- 
ments. While each of the segments 
listed below is actually composed of a 
separate code and data segment, for the 
purposes of this discussion the differen- 
tiation is not significant. 

While in protected mode the code 
must be pure. (The code is read/ex- 
ecute only and the data cannot be ex- 
ecuted.) Because you are in flat model, 
the only real restriction is that you not 
use a CS: override on data writes. How- 
ever, it is a good practice not to use CS: 
for data reads. 

At times you may want to change a 
selector register. The most common 
case is when you are copying memory 
to/from a 16-bit selector:offset passed 
from a Windows program. You can 
change any of the data selectors to any 
legitimate value you wish as long as 
you restore it as soon as you are done. 
If you are using a LDT selector, which 
is what a Windows program will pass 
you, make sure you are in the same VM. 


Real Mode 


A VxD is linked in a special .EXE for- 
mat. There is normally no regular EXE 
stub (unlike Windows apps that have 
WINSTUB.EXE). However, you can 
have a regular .EXE stub program. If 
WIN386 detects this stub, it will run it 
before Windows is ever placed into pro- 
tected mode. To include a real mode 
program, just link in a 16-bit real-mode 
program that includes a program entry 
point. In assembler you do this by put- 
ting the function name after the END at 
the end of the file. 

This real-mode program is essen- 
tially a totally separate program that is 
run before Windows begins. It is rare 
that this is needed and you should 
avoid it if at all possible. The most com- 
mon case where it is needed is when 
operations that require interrupts on 
must occur before or during the pro- 
tected mode Sys_Critical_Init, 
which doesn’t allow interrupts. When 
using this, be careful: what your real- 
mode init sees may not be there when 
Windows is totally up and running and 
vice-versa. A device may disappear or 
appear when Windows starts. 

A TSR or device driver can sit on int 
2Fh and, when Windows starts, request 
that a VxD be loaded. If the VxD does 
not have any real mode initialisation 
then you should make the TSR or de- 
vice driver the stub program. When 
started, the TSR or device driver can 
store the fully qualified path name of 
the file. You can then request the same 
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file when Windows starts. This will 
only fail if the file is moved before start- 
ing Windows. This capability allows 
you to write a dual mode device driver 
that works both in DOS and in Win- 
dows. 


MASM 5 is the only 
assembler which will 


create the proper 
object files. MASM 6 
is still too buggy 


Initialisation 


Each VxD has an initialisation seg- 
ment which is code and data that is 
needed during start-up but will be 
thrown away when it is complete. The 
initialisation segments for all of the 
VxDs are loaded before the first VxD, 
and are retained until the last VxD has 
completed its initialisation. Therefore, if 
there is some code/data that is needed 
only when other VxDs call your VxD, 
and they only call your VxD during in- 
itialisation, then it can be placed in the 
init segment, even though the memory 
is used during the initialisation of other 
VxDs. 


Swapable 


The rest of the memory that a VxD 
uses is needed for the life of Windows. 
Hopefully, most to all of the code and 
data can be placed in the swapable 
memory area. This memory can be 
swapped to disk if Windows is getting 
low on physical memory and your VxD 
hasn't been called in a while. 

As much memory as possible should 
be placed in the swapable memory seg- 
ment, except for code and data that 
must be in locked memory. The only 
other exception is code that will be ex- 
ecuted regularly, regardless of what is 
running. Code called every second by 
Excel does not qualify, because Excel 
may not be running. However, if your 
VxD is called every 2 seconds on the 
timer tick, the event handler for the tick 
(the code called asynchronously on the 
tick must be locked) could end up get- 
ting swapped out to disk after a second 
and then swapped back in - not terribly 
efficient. 

You just have to use your judgement 
(that’s why you're paid so much). If in 
doubt, put it in the swapable segment. 
Thrashing the disk is not as serious as 
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running out of physical memory. Also, 
at present, all VxD code and data is 
locked down. However, that doesn’t 
mean it will be in the future. 


Locked & Async 


The final segment is locked down 
memory. A segment that is locked will 
not be swapped out to disk and will not 
be moved in either physical or logical 
memory. The primary purpose of 
locked memory is to handle async ser- 
vices like IRQs. 

The Device Descriptor Block and its 
associated Device Control Procedure 
should be in locked memory. While 
they do not have to be in locked mem- 
ory, they are both accessed a lot by the 
VMM. The thought of the disk thrash- 
ing if these segments were swapable is 
horrendous, Lock them both down. 

Any Async services, including IRQ 
(hardware interrupt) procedures and all 
code and data they use, must be locked 
down. Be very careful that any function 
you might call and any data you might 
touch in an async call is locked down. 
Also, make certain that you only call 
VMM services that state that they can 
be called by async services. 

The memory management calls can- 
not be made during async time. How- 
ever, the linked list calls were designed 
so that they can be called during async 
time. These calls include calls to allocate 
memory for an element in the list. If 
you need to allocate memory during 
async time, use the linked list services. 


Device Descriptor Block 


The Device Descriptor Block is the 
VxD equivalent of a DOS device driver 
header. It holds a number of pieces of 
information in a set order. The file 
VMM.INC has a macro DECLARE_VIR- 
TUAL_DEVICE that lays the informa- 
tion out in the proper order. 

The first element is the device name. 
This is used primarily in some other 
macros in VMM.INC. Aside from that, 
itis not used for anything and there is 
no need for it to be unique. If you are re- 
placing an existing VxD, it is probably a 
good idea to use the existing VxD's 
name. 

The next two elements are the major 
and minor version number of the VxD. 
These are not the VxD’s version num- 
ber, but rather the version of Windows 
that the VxD has been tested up to. Ifa 
VxD has a version number of 3.10, then 
the VxD has been tested against Win- 
dows 3.00 and 3.10. Windows will use 
this number to determine how to 
handle a VxD. 


Next is the Device Control Proce- 
dure address. This function is called 
when the VMM wishes to pass a mess- 
age to the VxD (such as initialisation or 
termination). The Device Control Proce- 
dure can be built using the Con- 
trol_Dispatch macro in VMM.INC. 
Control_Dispatch uses a series of 
tests and conditional jumps, so make 
sure you put the most common ones 
first. If you handle a number of mess- 
ages that are commonly called, espe- 
cially the state changes, you may wish 
to use a dispatch table instead of the 
Control_Dispatch macro. Make 
sure that this procedure is in locked 
memory. 

Following this is the VxD ID. This 
value MUST be unique if your VxD ex- 
ports services to other VxDs or pro- 
vides call addresses to DOS or Win- 
dows apps. If you are replacing an exist- 
ing VxD and it is 101% upwardly 
compatible, use the existing VxD’s ID. 
In any other case, you must use a new, 
unique number. If your VxD provides 
services, a V86 API, or a Protected 
Mode (PM) API (all discussed later) the 
VxD ID is used to identify the VxD. 

If another VxD has the same ID, then 
all of these capabilities may go to the 
wrong VxD, Therefore, even if you 
don’t use any of the above capabilities, 
you must not have the same ID as any 
VxD that does use the above services. 
There is a VxD ID number in 
VMM.INC for VxDs that use none of 
these services (VMM_Device_ID) that 
you can use if you do not need any of 
these capabilities. 

If you do need an ID, don’t just pick 
one. Call or write Microsoft and ask for 
an ID number to be assigned to you. If 
you have On-line, request it through 
On-line. Request it several months in 
advance. When I requested one, I was 
originally declined because I’m an ass- 
hole (true, but irrelevant). It took sev- 
eral months before I finally received an 
ID. 

Next is the Initialisation order. This 
is where it is easiest to make a mistake. 
VxDs are initialised in the order of 
these numbers. Only if these numbers 
are equal does the order of the VxDs in 
SYSTEM.INI matter. You should never 
have to require that your device load 
first or last. In many cases a VxD won't 
care when it is initialised and should 
use Undefined_Init_Order as its in- 
itialisation order. If you do care, you 
generally want to initialise before or 
after a known VxD. Don’t place your 
order half-way between that VxD and 
the closest know VxD. Rather, if you 
want to initialise before the printer, set 
your order to ‘VPD_Init_Order - 10h’. If 
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you are replacing a standard VxD, use 
the same initialisation order. There may 
be other VxDs that will call your VxD 
that are depending on its initialisation 
order. 


Where code 

talking to 

hardware from DOS 
or Windows is slow, 
a VxD is fast 


Following this is the Service Table 
Name. The Service Table Name is a 
method of providing dynamic links be- 
tween VxDs. The first time a VxD calls 
a service in another VxD, an int 20h 
call will be made. The VMM will then 
replace that int with a near call to the 
service so that subsequent calls are di- 
rect near calls. 

The service table is the method that 
your VxD uses to call the VMM ser- 
vices. In each case, your VxD will call 
the appropriate VxD in the VMM. This 
is what makes it so easy to write a VxD 
that will replace one in EMM386.EXE. 

To create a service table, you use the 
macros Begin_Service_Table, 
End_Service_Table, and De- 
vice_Service and create a service 
table in an include file. Also, in one of 
the modules where you include the ser- 
vice table, you need to define Cre- 
ate_xxx_Service_Table where xxx 
is the name of your VxD. You also need 
to include the service table for in any 
other VxDs that will be calling your ser- 
vices. 

The first service should always be 
Get Version which returns the version 
number of the VxD in AX and clears 
carry. This is the version of the VxD it- 
self, not the Windows version it was 
written for. 


Tools 


There are a number of tools available 
for writing VxDs. First and foremost, 
you need the Windows DDK. This in- 
cludes the only manual for writing 
VxDs (it’s not great, but all of the infor- 
mation is buried in there somewhere). 
This also includes MASM 5, which is 
the only assembler I am aware of which 
will create the proper object files. 
MASM 6 will work - but is still too 
buggy to use in earnest. 

Second you need a debugger. The 


DDK includes WDEB386.EXE which is 
a powerful command line debugger 
that operates over your serial line toa 
terminal or terminal program. The alter- 
native is Soft-Ice for Windows, which 
also operates over a serial line but has a 
character-based, windowed program 
running on a second computer giving 
you a full-screen interface. Generally 
Soft-Ice is a lot easier to use. 

Finally, while I have not tested 
either, I have been told by both Meta- 
ware and Watcom that their 32-bit C 
compilers will produce .OB] files that 
can be linked into VxDs. However, 
since I have not seen this actually work, 
I would make sure that you can return 
the compiler if you buy it for this pur- 
pose. 

Unfortunately, while there are sev- 
eral books on VxDs in the works, none 
of them are out yet. While there is a lot 
more that could be written about VxDs, 
it would take a book to go into more de- 
tail. Hopefully, this article along with 
the VxD book in the DDK will be 
enough to get you started. If it’s any 
consolation, VxDs are actually pretty 
easy to write; it’s just that lack of do- 
cumentation that makes it difficult. 

Over the next several months, I will 
be discussing in .EXE Magazine how to 
write a VxD for the COM port. I will 
also attempt to cover any needs that a 
network card would require. This will 
include complete, heavily commented 
source code. If you want to see a VxD in 
action, stay tuned. 


David Thielen is a Senior Software De- 
sign Engineer in the DOS/Windows Busi- 
ness Unit, presently working on an unan- 
nounced product. Prior to joining Micro- 
soft, he was Director of Software 
Development at Harris & Paulson in Den- 
ver. 


The opinions expressed in this article 
are those of the author and not necessarily 
(in some cases definitely not) those of Micro- 
soft. 


Products mentioned: 


Microsoft tells us that the Windows 3.1 
DDK will be available from dealers or direct 
from MS (0734 270000) from the end of 
May, priced £335, or £99 to upgrade from 
the previous version. It is available both on 
3.5" disk and CD-ROM. Soft-Ice for Win- 
dows is distributed by System Science (071 
833 1022) and costs £259. Metaware High 
C24 and Watcom C-386 9 are both avail- 
able from all the main dealers; System 
Science quoted us £575 and £495 respective- 


ly. 
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PRODUCTS DIRECTORY 


Windows Products for 
Developers 


A handy kut-out 'n’ keep guide for those who enjoy 
kutting things out and keeping them. 


hen it was first mooted that we should have a direc- 
W:: of Windows products relevant to developers, I 

thought it would be a doddle. Half a dozen compi- 
lers, a couple or resource editors to put in, then off down the 
Dog & Biscuit for a quick pint. 

Not so. There is a huge number of relevant Windows pro- 
ducts out there - Software Paradise tells me that it is currently 
assembling a catalogue of 600. You'll find about 150 products 
below, so definitely no claims for completeness, although I 
trust we have the most important stuff taped. Apologies to 
those who were omitted. 

The rules for giving the source of a product are as follow. If 


the product is manufactured in the UK or comes from a com- 
pany with a UK presence, then that is the contact I have tried 
to give. If the product has a sole or principle distributor, then 
you will find his name and number listed. Otherwise, I have 
named the dealer who first provided me with information 
about the product. 

Most of these products are available from all four principle 
UK dealers (Grey Matter, Software Construction Company, 
Software Paradise and System Science). You may well be able 
to beat the price given here by ringing around all of them, so 
caveat emptor. Will Watts. 


Product 

Actor 4.0 

Actor 4.0 Professional 
APL*Plus II 386 


Borland C++ 3.0 with 
Application Frameworks 


Flex and 386-Prolog for 
Windows, Dev’s Ed 


Flex and 386-Prolog for 
Windows, Prog’s Ed 


GFA-BASIC for Windows 4.1 
Intel 386/486 C Code Builder Kit 
Kappa PC 

Logitech Modula-2 Dev Sys 


LPA 386-Prolog for Windows, 
Developer's Ed 


LPA 386-Prolog for Windows, 
Programmer’s Ed 


Metaware High C/C++ 3.0 
Microsoft C/C++ 7.0 


Microsoft Quick C for Windows 
Microsoft Visual Basic 


Prolog++ with 386-Prolog 
for Windows, Dev’s Ed 


Prolog++ with 386-Prolog 
for Windows, Prog’s Ed 


Prolog-2 

Realizer V1.0 
REXX/Windows 
Smalltalk V for Windows 
Stony Brook Pascal+ 
Stony Brook Prof Modula-2 
Topspeed C Prof 
Topspeed C++ Prof 

Turbo C++ for Windows 
Turbo Pascal for Windows 
Watcom C 9.0 


Languages 


Description 

OO Development Language 
OO Development Language 
APL language environment 


Compiler with support tools 
Expert system toolkit + runtime system 


Expert system toolkit 

BASIC environment 

32-bit C compiler 
Object-oriented development tool 
16-bit Modula-2 compiler 


Prolog Compiler + runtime system 


Prolog Compiler 
32-bit C++ compiler 


Compiler, support tools and 
Windows 3.1 SDK 


Compiler + Application generator 
Basic Interpreter 


OOP Prolog Compiler + runtime system 


OOP Prolog Compiler 

32-bit Prolog compiler 

Basic Interpreter 

REXX 

Smalltalk language environment 
16-bit Turbo Pascal compiler 
16-bit Modula-2 compiler 
Ccompiler 

C++ compiler 

Windows hosted C++ compiler 
Windows hosted Pascal compiler 
16-bit C compiler 
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Price 
£165 
£319 
£1200 


£439.95 


£2495 


£1245 
£200 
£370 
£2500 
£340 


£1495 


£745 
£475 


£335 
£125 
£139 


£1995 


£995 
£1495 
£295 
£95 
£330 
£220 
£265 
£165 
£165 
£119.95 
£149.95 
£275 


Supplier 

Software Construction Company 
Software Construction Company 
Cocking & Drury 


Borland 
LPA 


LPA 

GFA 

Grey Matter 
Intellicorp 
Grey Matter 


LPA 


LPA 
Grey Matter 


Microsoft 
Microsoft 
Microsoft 


LPA 


LPA 

Expert Systems Ltd 
Equinox Business Systems 
Software Paradise 
Cocking & Drury 
Grey Matter 

Grey Matter 

Grey Matter 

Grey Matter 
Borland 

Borland 

Grey Matter 


Contact no 

0763 244114 
0763 244114 
071 436 9481 


0734 321150 


081 8712016 


081 8712016 
0734 794941 
0364 53071 
0962 735348 
0364 53071 


081 8712016 


081 8712016 
0364 53071 


0734 270000 
0734 270000 
0734 270000 


081 8712016 


081 8712016 
0865 784474 
071 7290990 
0222 887521 
071 436 9481 
0364 53071 
0364 53071 
0364 53499 
0364 53499 
0734 321150 
0734 321150 
0364 53071 


a) 
programming 


editor for 
Windows 


@ Full Windows 
implementation 

Cut & Paste, nearly infinite Undo, 
Point and Click or key strokes control 
all features 


@ Multiple files and 
windows using MDI 

Load and view several files 
simultaneously in separate windows 


@ Folding text 

Manage large object modules with 
sections of text ‘folded’ up into a 
single line 


@ Code documentation 
Add ‘post-it’ style notes to any file 


@ Fully reconfigurable 
keyboard and menus 
Re-assign all keys and menus, make 
multiple key assignments 


@ Powerful macro 
language built-in 

Create and compile macros using 
any editor function with a Basic-like 
language 


@ £95 + VAT 


file edi 
ESE 


7 sample.h*7 

itdefine IDM_ABOUT 100 fii | 

long FAR PASCAL WndFnfHWND WORD, WORD,DWORD); 

Pe ong FAR PASCAL WrdFnWND Rwhd WORD message WORD wParamDWORD daParam) 
«  paRPROC lpProcAbout: F 


switch{message) { 
case WM_COMMAND: 


case WM_DESTROY: 
PostQuitMessage(0); 
break; 

case WM_MOUSEMOVE; [i | 


default: 
teturn(DefWindowProc(hWnd,message,wParam,dwParam)); 


} 
feturn(NULL); 


= EEE 
A: more and more users switch to Windows 8, the 


demand for Windows software continues to grow. Yet 

much of the developer’s toolkit still runs under DOS. 
Writing for Windows has always been more complex than for 
DOS, and project management can be especially tricky as 
Windows programs tend to be made up of large numbers of 
files. 


ix was developed to enhance programmer productivity. ix 
runs under Windows, and uses all the standard GUI features — 
MDI, split windows, cut & paste, choice of fonts and colours. It 
also contains several unique features which allow the developer 
far greater control. 


With ix you can edit and test within Windows - no more 
switching in and out of a DOS editor. Compilation/make files 
can be launched from a ‘Browse’ window. 


Browse windows help you keep track of the multiple files of 
a Windows project. A browser can be created for each project 
and used to fire up edit windows, launch resource editors (such 
as SDKpaint) and run programs as in Program Manager. 


‘Post-it’ style notes can be stuck onto any source file — 
without modifying the file. Their names can be used to give a 
hypertext-like help system throughout your project. 


And there's more; our AdHoc macro language, reassignable 
keys, custom menus and free telephone support, but we 
haven't got space to tell you about all that here. For more 
information, call or write us and we'll send you our information 
pack. 


e positive limited ¢ 
e 22 westminster buildings 
e new york street 
e leeds Is2 7dt 
© 0532 343 104 e 


Microsoft is a trademark and Windows is a trademark of the Microsoft Corporation. Positive Limited reserves the right to change the 
specification of ix without notice. 
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Watcom C/386 9.0 

Watcom Fortran 77 9.0 

Watcom Fortran 77/386 9.0 

WinBasic 

ZBASIC/PC for Windows 

Zortech C++ V3.0 - Developers Edition 


Zortech C++ V3.0 - Science & 
Engineering Edition 


Product 

3-in-1 

Advanced Easy Windows 
Application Generator 
Case:W for C 

dAnalyst Gold/Windows 
Easy Windows 

Easy Windows Case 

Easy Windows Report 
Enfin/2 

Instant Prototyper/Windows 
Instant Windows/Windows 
Liana Personal Developer 
M/4 for Windows 

Object Vision V2.0 
ProtoGen 

ProtoView 

Toolbook 

VZ Programmer 

WAPE 

WindowBuilder 
Windowcraft 
WindowsGENERATOR 
WindowsMaker Pro 
Winpro/3 


Product 

dBFast for Windows 
dIndex 

dIndex Professional 
IconAuthor 

Idealist for Windows 
InfoAlliance for Windows 
ODBMS 

Omnis Seven 

Omnis Seven Plus 


POET. 

PowerBuilder 

QtE 

Q+E Database Library 
Q+E Visual Basic 
Quadbase-SQL/Windows 
Quest for LANs 

Quest 

SequeLink 


Smalltalk SQL 

SQLJunction 

SQLWindows 3.0 Developer's System 
SQR 

Superbase 4 Windows 


PRODUCTS DIRECTORY 


C compiler for 32-bit applications 
16-bit FORTRAN compiler 

32-bit FORTRAN compiler 
Basicinterpreter/compiler 

Basic language 

C++ compiler and tools 


C++ compiler and tools + 
numerical facilities 


£599 


System Science 
Grey Matter 

Grey Matter 
Blackwell Software 
Software Paradise 
Symantech 


Symantech 


Development Systems/Prototypers 


Description 

Application generator 

Advanced application development 
errm, Application generator 
Interface builder and code generator 
Database application generator 
Application development 

CASE app dev 

Reporting for Easy products 

OO 4GL 

Prototyper 

Application generator 

Application development 
Application development 
Windows-hosted application generator 
Applications prototyper 

Front End builder and Code Generator 
Application development 
Application development 
Application generator 

Interface builder for Smalltalk V 
Application development 
Application generator 

Application generator 

Application generator 


Price 
£95/£145 
£199 
£549 
£645 
£299 
£99 
£399 
£199 
£2,500 
£299 
£799 
£109 
£750 
£89.95 
£75 
£295 
£247 
CALL. 
£169 
£145 
£249 
£189 
£695 
£239 


Databases 


Description 
Graphical Database development 
Multi-index database 


Multi-index database + colour form printing 


Multi-media authoring environment 
Full text database manager 

LAN-based Client/Server Data Access 
Object oriented database for Smalltalk V 
Database development system 
Database development system with 
SQL and graphics 

Object-oriented DBMS 

Client/Server Application Builder 
Database front end editor 

DLL Development tools 

Database for Visual Basic 

SQL engine 

LAN version of Quest 

Graphical access tool for SQL databases 


Enabling Technology for 
Client/Server computing 


Smalltalk Database interface 
Database interface 


SQL application development environment 


RDBMS reporting tool 
RDBMS with programming language 
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Price 
£339 
£109 
£139 
£2,650 
£275 
£395 
£1440 
£750 


£1500 
£299.95 
£1900+ 
£199 
£275 
£145 
£749 
£2345 
£495 


£1500 
£287 
£240 
£1495, 
£450 
£595 


Supplier 
Software Paradise 
March 

Software Paradise 
System Science 
Software Paradise 
March 

March 

March 

QA Training 
Software Paradise 
Software Paradise 
Software Paradise 
Micro Data Base Systems 
Borland 

System Star 
System Science 
Software Paradise 
Software Paradise 
Software Paradise 
Cocking & Drury 
Software Paradise 
Software Paradise 
Highland Grafix 
Software Paradise 


Supplier 

Computer Associates 
dL Soft 

dL Soft 

Aimtech 

Blackwell Software 
SPC 

Cocking & Drury 
Blythe 


Blythe 

Silicon River Ltd 
Admiral Software 
Contemporary S/W 
Contemporary S/W 
Contemporary S/W 
Software Paradise 
Gupta Technologies 
Gupta Technologies 


TechGnosis 
Cocking & Drury 
Cocking & Drury 
Gupta Technologies 
SPS 

SPC 


071 8331022 
0364 53071 
0364 53071 
0865 240201 
0222 887521 
0628 776 343 


0628 776 343 


Contact no 

0222 887521 
0734 404079 
0222 887521 
071 8331022 
0222 887521 
0734 404079 
0734 404079 
0734 404079 
0285 655888 
0222 887521 
0222 887521 

0222 887521 
081 903 0211 
0734 321150 
0992 500919 
071 8331022 
0222 887521 
0222 887521 
0222 887521 
071 436 9481 
0222 887521 
0222 887521 
03552 64888 
0222 887521 


Contact no 
0895 272501 
081 559 0049 
081 559 0049 
071 2501225 
0865 240201 
0344 867100 
071 436 9481 
0800 289 621 


0800 289 621 
081 3177777 
0276 692269 
0273 483979 
0273 483979 
0273 483979 
0222 887521 
0628 478333 
0628 478333 


061 474 1963 
071 436 9481 
071 436 9481 
0628 478333 
0483 730771 
0344 867100 


Superbase Developer Edition 
Superbase Runtime System 


Superbase SQL Library 
WindowBase V1.5 
Windows Personal Librarian API toolkit 


ZyIndex for Windows 


Product 

B-Tree Filer Network 

Blaise Win++ 

Btrieve for Windows 
C++/Views 

c-tree Plus 
C-TRIEVE/Windows 
C_talk/Views 
ChartBuilder for Visual Basic 
CodeBase 4.5 
CommonView 
Communications Library 
CrystalComm for Windows 
DataLIB/Windows 
DDELib 

Distinct TCP/IP for Windows 
Distinct TCP/IP SDK 
Drover’s Toolbox 

Graphics Server SDK 
Greenleaf Comm++ 
GUI_Master 

Halo Image File Format Library 
Imageman 

Instant Portable Library 
Instant Windows Utilities 
JTW C++ Library 
Linpack.h++ 

Magic Fields 

Math.h++ 

Matrix.h++ 

MemSHIELD 


Microsoft Professional Toolkit 
for Visual Basic 


Muscle 

Network Library 

NEWT-SDK 

Object Windows Library for C++ 
ObjectGraphics. 

ObjecTrieve 

ObjecTrieve/ VP 

OptiMem for Windows 
PDQComm for Windows 
Picture++ 

PowerLibW 

QuickPak Prof for Windows 
S-TEC for Windows/C version 
S-TEC for Windows/Pascal version 
TCXL Professional 6.0 
Tools.h++ 

VB/ISAM MX 

VBTools 

WinImage SDK 

WinMem 

ZAPP - 

Zinc Interface Library 


PRODUCTS DIRECTORY 


Superbase 4 with development toolkit 
5 User LAN extension 


Connectivity tool 
Windows relational database 


High volume text/imaging database 
with API 


Text retrieval system 


£995 
£225 


£295 
£395 


£16,000 


£275 


Code Libraries 


Description 

Turbo Pascal database library 
Application framework, with source 
Btrieve access library 

C++ class library 

C database library 

ISAM tool 

General 

Business Graphics Custom Control 
xBase access library 
Application Framework 
Visual Basic comms library 
Ccomms library 
Spreadsheet read/write 

DDE implementation library 
Network protocols 

TCP/IP library 

General 

Developer's Graphics Library 
C++ comms library 

C++ Application Framework 
Image file format conversion 
Imaging 

General 

General 

General 

C++ maths class library 
Input field validation library 
C++ maths class library 

C++ maths class library 
Memory manager library 


Custom controls/tools for Visual Basic 
Visual Basic library 

Visual Basic network library 
Network protocols 
Application Framework 
Graphics library for Pascal and C++ 
ISAM tool for Visual Basic 
Visual Basic database library 
Memory management 
Visual Basic comms library 
Imaging 

xBase file access 

Visual Basic library 

Sprite Graphics Library 
Sprite Graphics Library 
C/C++ screen library 

C++ class library 

Visual Basic database library 
Visual Basic library 

Image file format library 
Memory management 
Application framework 

C++ Application Framework 


Price 
£99 
£150 
£345 
£359 
£310 
£295 
£299 
£99 
£255 
£399 
£90 
£100 
£329 
£225 
£179 
£395 
£229 
£275 
£110 
£380 
£195 
£349 
CALL 
£129 
£139 
£185 
£350 
£69 
£125 
£335 


£199 
£125 
£69 
CALL 
£49.95 
£129 
£169 
£250 
£139 
£69 
CALL 
£249 
£120 
£100 
£86 
£195 
£69 
£59 
£115 
£199 
£85 
CALL 


£299.95 


SPC 
SPC 


SPC 
SPI 


Systematic Upgrade 
Grey Matter 


Supplier 

Grey Matter 
System Science 
System Science 
Liant 

Grey Matter 
Software Paradise 
Software Paradise 
Bits Per Second 
Software Construction Company 
QA Training 
Grey Matter 

Grey Matter 
Software Paradise 
System Science 
Software Paradise 
Grey Matter 
Software Paradise 
Bits Per Second 
Grey Matter 

Grey Matter 
System Science 
Software Paradise 
Software Paradise 
Software Paradise 
Software Paradise 
Grey Matter 
Highland Grafix 
Grey Matter 

Grey Matter 
System Star 


Microsoft 

Grey Matter 

Grey Matter 
Software Paradise 
Borland 

Software Construction Company 
Software Paradise 
Grey Matter 
Software Paradise 
Grey Matter 
Software Paradise 
Software Paradise 
Grey Matter 
Media Apps 
Media Apps 

Grey Matter 

Grey Matter 

Grey Matter 

Grey Matter 
Highland Grafix 
Software Paradise 
Software Paradise 
Zinc Software UK Ltd 
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0344 867100 
0344 867100 


0344 867100 
0734 844 081 


081 441 9792 
0364 53071 


Contact no 
0364 53071 
071 8331022 
071 8331022 
071 7992434 
0364 53071 
0222 887521 
0222 887521 
0273 727119 
0763 244114 
0285 655888 
0364 53071 
0364 53071 
0222 887521 
071 8331022 
0222 887521 
0364 53071 
0222 887521 
0273 727119 
0364 53071 
0364 53071 
071 8331022 
0222 887521 
0222 887521 
0222 887521 
0222 887521 
0364 53071 
03552 64888 
0364 53071 
0364 53071 
0992 500919 


0734 270000 
0364 53071 
0364 53071 
0222 887521 
0734 321150 
0763 244114 
0222 887521 
0364 53071 
0222 887521 
0364 53071 
0222 887521 
0222 887521 
0364 53071 
071 482 6220 
071 482 6220 
0364 53071 
0364 53071 
0364 53071 
0364 53071 
03552 64888 
0222 887521 
0222 887521 
081 8559918 
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Product 

CcVv/1 

Microsoft Source Profiler 
Microsoft Test for Windows 
Multiscope for Windows 
Periscope/32 for Windows 
Profile V 

Soft-Ice/W 

Threadz Observer 


Product 

CodePad 

CodeWright 

CView 

Ed for Windows 

ix 

SpeedEdit for Windows 
WinEdit 


Product 

Arcadia DM for Windows 
Blaise Windows Control Palette 
Borland Resource Workshop 
ButtonTool & EditTool 

C+0 for Windows 
Dazzle/VB 

DbxSHIELD 

dClip 

DialogCoder 

InControl Toolbox 

P.OEM Colour 2.1 

P.OEM Grayscale 2.0 
P.OEM Video 2.0 

Panel Plus II 

PCX Toolkit for Windows 
PictureBox for Windows 
PowerShoW 

ProtoView 


Sage Control Pak/W 
TbxSHIELD 
Whitewater Resource Toolkit 


Product 
Optlink/Windows 
Windows Source 

Ergo DMP16 

RFFlow 

MetaDesign 
DemoSHIELD 

dLabel 

dLabel Professional 
InstalISHIELD 
LogSHIELD 

Microsoft Windows DDK 
Microsoft Windows SDK 
RoboHelp 


PRODUCTS DIRECTORY 


Debuggers/Testers/Profilers 


Description 

CodeView in a Window 
Windows-compatible profiler 
Regression testing tool 
Debugger 

Debugger 

Profiler for Smalltalk V 
Debugger for Win Apps, VxDs 
Debugger 


Description 

Programmer's Editor 
Programmer's Editor 
Programmer's Editor 
Programmer's Editor 
Programmer's Editor 
Programmer's Editor 
Programmer's Editor 


Resources and User interface 


Description 

User interface tool 

Resource Library 

Integrated Windows resource editors 
Visual Basic tools 

User interface tool 

Visual Basic image library 

Dialog box designer 

Screen Capture/Presentation System 
Dialog box generator 

User interface tool 

Colour still image decompression 
Greyscale still image decompression 
Motion video decompression 

Screen Generator/Library 

PCX library 

Presentation development 

Image library 


Screen painter /Dialog editor 
+ screen management 


User interface tool 
Customisable toolbox controls 
Resource editor 


Price 
£95 
£55 
£279 
£270 
£235 
£175 
£259 
£449 


Price 
£75 
CALL 
£85 
£199 
£95 
£279 
£115 


Price 
£549 
£95 
£29.95 
£59 
£149 
£199 
£335 
£89 
£479 
CALL 
£3500 
£2795 
£3500 
£285 
£135 
£149 
£325 


£330 
£449 
£255 
£65 


Miscellaneous 


Description 

Linker 

Disassembler 

16-bit DOS extender 

Flowcharter 

Diagrammer 

Demo building application 
Label printing 

Colour label/barcodes design 
Graphical Installation Program Builder 
Session recording / playback tool 
Tools for Windows device driver 
Tools for Windows development 
Help file authoring 
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Price 
£290 
£105 
£495 
£65 
£260 
£415 
£69 
£89 
£255 
£335 
£335 


Supplier 

System Science 
Microsoft 
Microsoft 

Grey Matter 
Grey Matter 
Cocking & Drury 
System Science 
Threadz 


Supplier 
Software Paradise 
Software Paradise 
Software Paradise 
QBS 

Positive Ltd 
Software Paradise 
Software Paradise 


Supplier 
Software Paradise 
System Science 
Borland 

Grey Matter 
Software Paradise 
Grey Matter 
System Star 

dL Soft 

Software Paradise 
Software Paradise 
Iterated 

Iterated 

Iterated 
Roundhill Computer Systems 
Grey Matter 
Highland Grafix 
Grey Matter 


System Star 

Software Paradise 

System Star 

Software Construction Company 


Supplier 
Grey Matter 
Grey Matter 
Grey Matter 
Grey Matter 
Grey Matter 
System Star 
dL Soft 

dL Soft 
System Star 
System Star 
Microsoft 
Microsoft 
Highland Grafix 


Contact no 
071 8331022 
0734 270000 
0734 270000 
0364 53071 
0364 53071 
071 436 9481 
071 8331022 
0532 703233 


Contact no 
0222 887521 
0222 887521 
0222 887521 
081 994 4842 
0532 343104 
0222 887521 
0222 887521 


Contact no 
0222 887521 
071 8331022 
0734 321150 
0364 53071 
0222 887521 
0364 53071 
0992 500919 
081 559 0049 
0222 887521 
0222 887521 
0734 880261 
0734 880261 
0734 880261 
0672 84535 
0364 53071 
03552 64888 
0364 53071 


0992 500919 
0222 887521 
0992 500919 
0763 244114 


Contact no 
0364 53071 
0364 53071 
0364 53071 
0364 53071 
0364 53071 
0992 500919 
081 559 0049 
081 559 0049 
0992 500919 
0992 500919 
0734 270000 
0734 270000 
03552 64888 


Upgrading Windows? 
Don’t forget to upgrade your mug. 


Available in a wide choice of one colour, one size and one message, the EXE Magic Windows Mug 
is the ultimate symbol of style, the apex of art, the Complete Coffee Cup. 


The .EXE Magic Windows Mug features: 
€ Heat sensitivity derived from Apollo 13 technology (for all we know) 


3 Mouse cursor and the timeless message ‘Here It Is’ appear when 
hot ultra caffeinated coffee (or the poison of your choice) is added 
to the mug. 


%€ 100% compatible with Windows 3.1 and OS/2 2.0 

€ Never gives UAE or crashes (unless YOU drop it) 

€ Includes screen design bug - can you spot it? 

%*€ Guaranteed 100% waterproof. 

Marvel at the usefulness of a mug which tells you that your coffee is... 


A Stone cold 
B_ Tastes like a bad code walk through at 6.30pm 
on a Bank Holiday Friday 


Available in limited numbers (until we order some more) for the minute 
sum of £3.75 (100% deposit now, and NOTHING more to pay). 


You know you need the .EXE Magic Windows Mug 


Complete the form below to order your mug. Please add £1.50 p&p 


Fig 3 - Errr.... 


aos TALIA Naat ab ead TT aST a Me NINA ins OI Ddal lt hi annasnioneinsndn POsttode Sash unnewniN ecg tania 


Please send me -EXE Magic Windows Mug(s) 


ial T enclose a cheque for £. 
[] Please debit my VISA/Access Card by £ Gard INO’. cntSnn socom erence ees 


Please return to Process Communications, 10 Barley Mow Passage, London W4 4PH. Tel: 081 994 6477 


The way we discover 


and create should never be 


limited by elements 


only by our imagination. 


ZIinC tNTERFACE Li BRARY 3.0 


Imagine an object-oriented development tool for C++ that is = Acomprehensive set of interface objects including windows, 
more powerful than Windows or DOS specific tools. Imagine a menus, scrollbars, icons, radio buttons, tool bars, lists, input 
transparent, single source code migration path between Fields (string, text, date, time, number), keyboard, mouse, help... 
Microsoft Windows 3.X, DOS Graphics and DOS Text. Now a Single package support for Borland C++, Microsoft C+ and 

turn your imagination loose with Zinc” Interface Library” 3.0. Zortech C++ (Symantec) compilers. 

= Extensible, object-oriented, event-driven application framework. Call 1.800.638.8665 [IN EUROPE CALL: +44 (0)81 855 9918] and 
= Fully optimized, single source code support for Microsoft we'll send you a technical information packet detailing Zinc 3.0. 


Windows 3.X, DOS Graphics and DOS Text. 


Zinc Designer"—an interactive design tool for creating and saving 


application screens with platform-independent persistent objects. 


> CIRCLE NO. 089 


©1992 ZINC SOFTWARE INCORPORATED: 801.785.8900: FAX 801.785.8996; BBS 801.785.8997 [EUROPE] ZINC SOFTWARE (UK) LTD: +44 (0)81 855 9918; FAX: +44 (0)81 316 7778; BBS: +44 (0)81 317 2310 


CALL 081 855 9918 FOR YOUR FREE ZINC V3.0 DEMO DISK 


